​

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

​

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

​

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