API Reference tasks

Retry a task

POST/projects/{project_id}/tasks/{task_id}/retry/

Retry a failed task — error_message is cleared and progress restarts from zero.

Request

curl -X POST "$ALLYBUILD_API_URL/projects/$PROJECT_ID/tasks/$TASK_ID/retry/" \
  -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
}