Skip to main content
GET
/
task-runs
List task runs
curl --request GET \
  --url https://api.deck.co/v2/task-runs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "status": "<string>",
      "result": "<string>",
      "task_id": "<string>",
      "credential_id": "<string>",
      "session_id": "<string>",
      "workflow_id": "<string>",
      "agent_id": "<string>",
      "source_id": "<string>",
      "runtime_ms": 123,
      "input": null,
      "output": null,
      "storage": [
        {
          "id": "<string>",
          "object": "<string>",
          "file_name": "<string>",
          "file_type": "<string>",
          "file_size": 123,
          "created_at": "2023-11-07T05:31:56Z"
        }
      ],
      "errors": [
        {
          "type": "<string>",
          "code": "<string>",
          "message": "<string>",
          "field": "<string>"
        }
      ],
      "interaction": null,
      "canceled_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>",
  "request_id": "<string>"
}

Authorizations

Authorization
string
header
required

Clerk JWT, client credential JWT, or secret key (sk_live_...)

Query Parameters

Limit

Maximum number of items to return (1-100, default 20)

starting_after
string

Cursor for forward pagination. Pass the ID of the last item from the previous page.

ending_before
string

Cursor for backward pagination. Pass the ID of the first item from the previous page.

status
string[]

Filter by status: queued, running, cancelling, interaction_required, completed, canceled, failed

source_id
string[]

Filter by source ID

outcome
string[]

Filter by outcome value

agent_id
string
credential_id
string
task_id
string
workflow_id
string
created_after
string<date-time>
created_before
string<date-time>

Response

OK

data
object[]
has_more
boolean
next_cursor
null | string
request_id
null | string