Executions API

List Executions

GET /api/v1/projects/{project_id}/executions
Authorization: Bearer <token>

Response 200 OK

[
  {
    "id": "uuid",
    "plan_id": "uuid",
    "project_id": "uuid",
    "status": "running",
    "started_at": "2026-01-01T00:00:00Z",
    "pipeline_stages": [
      { "node_type": "design", "status": "completed", "title": "Design: User Registration" },
      { "node_type": "coding", "status": "in_progress", "title": "Implement: User Registration API" },
      { "node_type": "testing", "status": "pending", "title": "Test: User Registration" },
      { "node_type": "review", "status": "pending", "title": "Review: User Registration" }
    ]
  }
]

Get Execution

GET /api/v1/executions/{execution_id}
Authorization: Bearer <token>

List Execution Nodes

GET /api/v1/executions/{execution_id}/nodes
Authorization: Bearer <token>

Response 200 OK

[
  {
    "id": "uuid",
    "graph_id": "uuid",
    "node_type": "coding",
    "title": "Implement User Registration API",
    "status": "completed",
    "agent_type": "claude-code",
    "token_usage": 15000,
    "cost_usd": 0.45,
    "started_at": "2026-01-01T00:10:00Z",
    "finished_at": "2026-01-01T00:15:00Z"
  }
]

Start Execution

POST /api/v1/executions/{execution_id}/start
Authorization: Bearer <token>

Requires at least one runtime daemon to be online.

Pause / Resume

POST /api/v1/executions/{execution_id}/pause
Authorization: Bearer <token>
Content-Type: application/json
{ "reason": "Need to review before continuing" }

POST /api/v1/executions/{execution_id}/resume
Authorization: Bearer <token>
Content-Type: application/json
{}

Rollback

POST /api/v1/executions/{execution_id}/rollback
Authorization: Bearer <token>
Content-Type: application/json

{
  "reason": "Requirements changed, need to start over"
}

Rollback will:

1. Cancel all in-progress and pending nodes
2. Revert associated work items to todo
3. Reset git branch to default
4. Create audit log

Retry Failed Node

POST /api/v1/executions/nodes/{node_id}/retry
Authorization: Bearer <token>

Re-enqueues a failed node for re-execution.

Get Execution Output

GET /api/v1/executions/{execution_id}/output
Authorization: Bearer <token>

Returns aggregated output from all nodes.