List Schedules

GET/v1/schedules

List definitions with offset pagination.

Query parameters

Optional<string>status

active, paused, archived, or all. Other values return 400.

Default: active

Optional<string>agent_id

Only definitions bound to this Agent.

Optional<integer>limit

Page size up to 100; values above 100 return 400, and 0 or non-numeric values fall back to 20.

Default: 20

Optional<integer>offset

Number of records to skip.

Default: 0

curl -X GET "https://api.sandbase.ai/v1/schedules?status=active&limit=20" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "data": [
    {
      "id": "sch_7e3b1c58-2a9d-5e4f-b6c1-8d0a2f4e6b17",
      "kind": "schedule",
      "name": "Daily digest",
      "description": "",
      "agent_id": "agt_8c1f2b9e-3d4a-4f6b-9c2e-1a7d5e3b4c60",
      "agent_version": 3,
      "input": "Summarize the previous day of AI agent news.",
      "status": "active",
      "row_version": 1,
      "schedule": {
        "cron": "0 9 * * 1-5",
        "timezone": "Asia/Shanghai"
      },
      "next_run_at": "2026-10-07T01:00:00Z",
      "created_at": "2026-10-06T08:00:00Z",
      "updated_at": "2026-10-06T08:00:00Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}