GET

/api/catch/:id

Pick up a baton and start working.

Parameters

id

string · required

The baton ID from the pickup URL.

Example

Code

curl https://b4ton.sh/api/catch/abc-123 \
  -H "Authorization: Bearer baton_abc123..."

Response

Code

{
  "baton_id": "abc-123",
  "status": "caught",
  "task": "Review this draft email",
  "output": { "draft": "Hello..." },
  "context": { "tone": "professional" },
  "constraints": null,
  "created_at": "2026-03-17T12:00:00Z"
}

Side effects

Calling this endpoint transitions the baton from pending to caught. Once caught, the baton cannot be caught again. Use /api/status/:id to check without side effects.