Tickets API - Draft

Create a Ticket

curl -X POST http://localhost:8000/tickets \
  -H "Content-Type: application/json" \
  -d '{
    "goal_id": "goal-uuid",
    "title": "Add health endpoint",
    "description": "Create a GET /health endpoint returning JSON status"
  }'

Get a Ticket

curl http://localhost:8000/tickets/{id}

Transition State

curl -X POST http://localhost:8000/tickets/{id}/transition \
  -H "Content-Type: application/json" \
  -d '{"state": "planned"}'

Valid transitions follow the state machine.

Execute a Ticket

curl -X POST http://localhost:8000/tickets/{id}/run

Creates a job that spawns the AI executor in the ticket’s worktree. Response:

{
  "id": "job-uuid",
  "status": "queued",
  "ticket_id": "ticket-uuid",
  "job_type": "execute"
}

Verify a Ticket

curl -X POST http://localhost:8000/tickets/{id}/verify

Runs verification commands defined in draft.yaml.

Get Ticket Events

curl http://localhost:8000/tickets/{id}/events

Returns the full event history (state changes, comments, etc.).

List Jobs for a Ticket

curl http://localhost:8000/tickets/{id}/jobs

Get Evidence for a Ticket

curl http://localhost:8000/tickets/{id}/evidence

Returns verification evidence (stdout, stderr, exit codes) for all jobs.