Api / Todos

GET/v1/todos/:id

Auth: tenant — Status: stable

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

Request

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

Response

200 OK

{
  "todo": {
    "id": 14,
    "conversation_id": 7,
    "agent_id": "index",
    "subject": "review the deploy",
    "description": "check logs + metrics",
    "status": "completed",
    "position": 1,
    "created_at": 1746720000,
    "updated_at": 1746720240,
    "completed_at": 1746720240
  }
}

Failure modes

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

See also