List workspace runs

Lists account-scoped runs. Requires run:read.

GET/runs

Authorization

AuthorizationBearer <token>

Query parameters

agent_idstring

pattern: "^agt_[A-Za-z0-9]+$"

statestring

enum: ["idle","busy"]

created_afterinteger

minimum: 0

created_beforeinteger

minimum: 0

limitinteger

minimum: 1
maximum: 100
default: 20

afterstring

Response

application/json

Run list

object

objectstringrequired

const: "list"

dataarrayrequired

Show nested schema

Array items

object

Additional properties are allowed.

idstringrequired

pattern: "^run_[A-Za-z0-9]+$"

objectstringrequired

const: "run"

agent_idstringrequired

pattern: "^agt_[A-Za-z0-9]+$"

agent_versionintegerrequired

minimum: 1

statestringrequired

enum: ["idle","busy"]

created_atintegerrequired

minimum: 0

last_activity_atintegerrequired

minimum: 0

has_morebooleanrequired

next_cursorstring | nullrequired

curl --request GET \
  --url 'https://YOUR_SALAMBO_BASE_URL/api/v1/runs' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Replace placeholders with your values.

Response

{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "object": "run",
      "agent_id": "<string>",
      "agent_version": 123,
      "state": "idle",
      "created_at": 123,
      "last_activity_at": 123
    }
  ],
  "has_more": true,
  "next_cursor": "<string | null>"
}