workflows.deployments

Get Deployment Logs

Changed on

Retrieve logs for a deployment (across all of its workers).

Use after/before/order on the first request to set the time range and sort order; for the next pages pass the cursor from the previous response (it remembers the range and order).

log_type=build serves the managed build pipeline's output instead. It pages the same way, and a null next_cursor means the window is drained.

get/v1/workflows/deployments/{name}/logs

Request

Path parameters

namestring required

Query parameters

log_type'build' | 'runtime'

Which log stream a deployment's logs come from.

runtime is what the workers themselves emit. build only exists for managed deployments: it is the image build pipeline's output, which no worker reports.

Which stream to read. 'runtime' is the workers' own logs; 'build' reads the image build output and requires a managed deployment.

worker_namestring nullable

Filter logs by worker name

workflow_namestring nullable

Filter logs by workflow name

afterstring date-time nullable

Only return logs at or after this timestamp

beforestring date-time nullable

Only return logs before this timestamp

order'asc' | 'desc'

First-page sort order: 'asc' (oldest first) or 'desc'. Ignored when cursor is set.

cursorstring nullable

Pagination cursor from a previous response's next_cursor; carries the window and order

limitinteger

Maximum number of logs to return

Response

Successful Response

next_cursorstring nullable

Changes