Skip to main content
POST
List logs

Authorizations

Authorization
string
header
required

API token from cargo-ai login. Send as Authorization: Bearer <token>.

Headers

Idempotency-Key
string

Client-generated key that makes this write safe to retry. Reusing the same key with the same request returns the original response instead of creating a second record. Reusing it with a different request returns 422. A concurrent retry while the first request is still running returns 409. Keys expire after 24 hours. Not accepted on multipart file uploads. Optional: a request without one is processed as it always was.

Maximum string length: 255
Example:

"8e03978e-40d5-43e8-bc93-6894a57f9324"

Body

application/json

Request body schema.

workerUuid
string<uuid>
required

Worker whose logs to list.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
runUuid
string<uuid>

When set, only logs for this run are returned.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
levels
enum<string>[]

Log levels to include.

Available options:
log,
info,
warn,
error,
debug

Match against the log message or attributes.

Required string length: 1 - 512
occurredAfter
string

Include logs that occurred after this ISO timestamp.

occurredBefore
string

Include logs that occurred before this ISO timestamp.

limit
integer

Maximum number of log lines to return.

Required range: 1 <= x <= 500
offset
integer

Number of log lines to skip.

Required range: 0 <= x <= 9007199254740991

Response

List logs

logs
Logs · object[]
required

Log lines matching the filters.