Api / Schedules

GET/v1/schedules/:id

Auth: tenant — Status: stable

Fetch one scheduled task by id. Tenant-scoped: a leaked id never surfaces another tenant's row.

Request

curl -H "Authorization: Bearer atr_…" \
     http://arbiter.example.com/v1/schedules/17

Response

200 OK

Same scheduled_task shape as POST/v1/schedules.

{
  "scheduled_task": {
    "id": 17,
    "agent_id": "reviewer",
    "schedule_phrase": "every monday at 09:00",
    "schedule_kind": "recurring",
    "next_fire_at": 1746864000,
    "status": "active",
    "run_count": 4,
    "last_run_at": 1746720185,
    "last_run_id": 42,
    "...": "..."
  }
}

Failure modes

StatusWhen
401Missing / invalid bearer.
404Schedule not found for this tenant.

See also