Skip to main content

​
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

ParameterTypeDescription
task_uuidstringThe 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

FieldTypeDescription
taskIdstringThe unique identifier of the task
statusstringCurrent status of the task
errorMessagestring | nullError message if task failed, null otherwise
updatedAtstringISO 8601 timestamp of the last status update
errorstringError 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