Skip to main content
GET
Get logs for a deployment. Supports filtering by log type and searching within logs.

Path Parameters

string
required
The deployment ID (e.g., dep_abc123xyz)

Query Parameters

string
Log type: build, deploy, or runtime. If omitted, returns all types.
integer
default:"20"
Number of runtime log lines to include (1-500)
Filter logs containing this text. Supports:
  • Single term: error
  • Multiple terms (OR): error,warning,failed
  • Regex patterns: HTTP.*[45]\d\d

Response

string
The deployment ID
array
List of log entries
string
Log source: stored (database) or fly (live from Fly.io)
string
Instructions for getting logs if unavailable via API
Build and deploy logs are stored permanently. Runtime logs are fetched live from Fly.io and may not be available if the app is not running.