GET/v1/schedules

Auth: tenant — Status: stable

List the calling tenant's scheduled tasks. Newest updated_at first; hard-capped at 200.

Request

Query parameters

curl -H "Authorization: Bearer atr_…" \
     "http://arbiter.example.com/v1/schedules?status=active"

Response

200 OK

{
  "schedules": [
    {
      "id": 17,
      "agent_id": "reviewer",
      "conversation_id": 0,
      "message": "summarise the week's PRs",
      "schedule_phrase": "every monday at 09:00",
      "schedule_kind": "recurring",
      "fire_at": 0,
      "recur_json": "{\"every\":\"week\",\"day\":\"mon\",\"at\":\"09:00\"}",
      "next_fire_at": 1746864000,
      "status": "active",
      "created_at": 1746720000,
      "updated_at": 1746720000,
      "last_run_at": 0,
      "last_run_id": 0,
      "run_count": 0
    }
  ]
}

Failure modes

See also

• POST/v1/schedules, GET/v1/schedules/:id, GET/v1/schedules/:id/runs
• Scheduler concept