API Reference tasks

Get a task

GET/projects/{project_id}/tasks/{task_id}

Fetch one task instance — status, current phase, progress, dependencies, and error details.

Request

curl "$ALLYBUILD_API_URL/projects/$PROJECT_ID/tasks/$TASK_ID" \
  -H "Authorization: Bearer $TASK_JWT" \
  -H "Content-Type: application/json"

Response

{
  "id": "9a2b8c7d-1e2f-4a5b-8c9d-0e1f2a3b4c5d",
  "name": "weekly-report",
  "task_type_id": "5f4e3d2c-...",
  "params": {"month": "2026-10"},
  "status": "pending",
  "current_phase": null,
  "progress": 0,
  "created_at": "2026-10-01T12:00:00Z",
  "started_at": null,
  "finished_at": null,
  "dependencies": [],
  "error_message": null,
  "pr_url": null
}