Deployments.ai Docs
Runtime

List what the runtime logged while executing a run

GET /v1/runs/{runId}/logs · SDK listRunLogs · CLI deployments run logs

GET
/v1/runs/{runId}/logs

Requires runs:read.

Authorization

headerAuthorizationBearer <token>

Opaque bearer credential scoped to one service account and tenant.

Path Parameters

runId*string
Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Query Parameters

cursor?string

Opaque cursor returned by the previous page.

Length1 <= length <= 4096
limit?integer

Maximum number of lines to return.

Range1 <= value <= 500
level?string

Only lines at this level or more severe.

Value in"debug""info""warn""error"
source?string

Only lines from this source.

Value in"runtime""model""tool""sandbox""hosted-code"
toolCallId?string

Only lines written by this tool call.

Length26 <= length <= 26
from?string

Only lines written at or after this time (RFC 3339).

Formatdate-time
to?string

Only lines written before this time (RFC 3339).

Formatdate-time

Header Parameters

x-deployments-environment?string

Required with a platform bearer JWT, where the three tenant headers select an environment the caller can access through active organization membership. Optional with an API key; when supplied, it must match the key's tenant.

Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$
x-deployments-organization?string

Required with a platform bearer JWT, where the three tenant headers select an environment the caller can access through active organization membership. Optional with an API key; when supplied, it must match the key's tenant.

Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$
x-deployments-project?string

Required with a platform bearer JWT, where the three tenant headers select an environment the caller can access through active organization membership. Optional with an API key; when supplied, it must match the key's tenant.

Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Response Body

ListRunLogsResponse

application/json
  1. response
caughtUp*boolean
logs*array<>
nextCursor*string
Length1 <= length <= 4096
curl -X GET "https://example.com/v1/runs/string/logs"
{  "caughtUp": true,  "logs": [    {      "attributes": {        "property1": true,        "property2": true      },      "attempt": 0,      "id": "string",      "level": "debug",      "message": "string",      "runId": "string",      "source": "runtime",      "spanId": "string",      "threadId": "string",      "time": "2019-08-24T14:15:22Z",      "toolCallId": "string",      "traceId": "string"    }  ],  "nextCursor": "string"}