Get Task Status

Retrieve the current processing status and details of an HDP task by its UUID

Get Task Status

Retrieves the current status of a scheduled Data Processor task. This endpoint does not require authentication.

Endpoint

GET /tasks/{task_uuid}/status

Path Parameters

Parameter	Type	Description
task_uuid	string	The unique identifier (UUID) of the task

Example Request

curl -X GET https://staging.hdp.api.herodotus.cloud/tasks/01JPJ03YJT1A93D6NF56G4GVEQ/status \
  -H "Content-Type: application/json"

Response

Success Response (200 OK)

{
  "taskId": "01JPJ03YJT1A93D6NF56G4GVEQ",
  "status": "AtlanticProvingStarted",
  "errorMessage": null,
  "updatedAt": "2024-03-17T10:24:00Z"
}

Not Found Response (404)

{
  "error": "Task not found",
  "taskId": "01JPJ03YJT1A93D6NF56G4GVEQ"
}

Server Error Response (500)

{
  "error": "Internal Server Error"
}

Response Fields

Field	Type	Description
taskId	string	The unique identifier of the task
status	string	Current status of the task
errorMessage	string | null	Error message if task failed, null otherwise
updatedAt	string	ISO 8601 timestamp of the last status update
error	string	Error message (only present in error responses)

Possible Status Values

• Received: Task has been received and is queued
• DryRunStarted: Dry run validation has started
• DryRunCompleted: Dry run validation completed successfully
• DryRunFailed: Dry run validation failed
• ChainProofsFetchStarted: Started fetching chain storage proofs
• ChainProofsFetchCompleted: Chain proofs fetched successfully
• ChainProofsFetchFailed: Failed to fetch chain storage proofs
• TraceGenStarted: Trace generation has started
• TraceGenCompleted: Trace generation completed successfully
• TraceGenFailed: Trace generation failed
• AtlanticProvingStarted: Atlantic proving has started
• AtlanticProvingCompleted: Atlantic proving completed successfully
• AtlanticProvingFailed: Atlantic proving failed
• TaskDecommitmentStarted: Task decommitment has started
• TaskDecommitmentCompleted: Task decommitment completed successfully. This is the final status for completed workflows.
• TaskDecommitmentFailed: Task decommitment failed

Notes

• No authentication is required for this endpoint
• The response includes the task ID and current status
• For completed tasks, the response includes the completion timestamp
• If the task failed, the error message will be included in the response
• The status endpoint can be polled to track task progress