List runs

GET

agent

run

{
  "runs": [
    {
      "id": "<string>",
      "agentId": "<string>",
      "prompt": "<string>",
      "model": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "startedAt": "2023-11-07T05:31:56Z",
      "completedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

{
  "statusCode": 123,
  "statusMessage": "<string>",
  "message": "<string>"
}

{
  "statusCode": 123,
  "statusMessage": "<string>",
  "message": "<string>"
}

{
  "statusCode": 123,
  "statusMessage": "<string>",
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

API key starting with sk_case_

Query Parameters

agentId

string

Filter by agent ID

status

enum<string>

Filter by run status

Available options:

queued,

running,

completed,

failed,

cancelled

limit

integer

default:50

Maximum number of runs to return (default 50, max 250)

Required range: 1 <= x <= 250

cursor

string

Pagination cursor (run ID from previous page). Returns runs created before this run.

Response

List of runs

runs

object[]

Show child attributes

hasMore

boolean

nextCursor

string | null

Pass as cursor to fetch the next page

Create runCreates a run in queued state. Call POST /agent/v1/run/:id/exec to start execution.

⌘I

{
  "runs": [
    {
      "id": "<string>",
      "agentId": "<string>",
      "prompt": "<string>",
      "model": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "startedAt": "2023-11-07T05:31:56Z",
      "completedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

{
  "statusCode": 123,
  "statusMessage": "<string>",
  "message": "<string>"
}

{
  "statusCode": 123,
  "statusMessage": "<string>",
  "message": "<string>"
}

{
  "statusCode": 123,
  "statusMessage": "<string>",
  "message": "<string>"
}

Agents

Connectors

Usage

Vaults

Compute

System

Legal

LLMs

Matters

Media

Memory

OCR

Privilege

Search

Skills

Translation

Voice

Webhooks

Authorizations

Query Parameters

Response