Get Hedra Job Status
hedra_get_job_statusPoll a job's current status and progress while it runs, offering a lightweight way to monitor long-running tasks. Returns status, progress, and estimated completion time in one call.
Instructions
Lightweight poll of a job's current status and progress — cheaper than hedra_get_job for repeated polling while a job is still running.
Args:
job_id (string, required): the job id from hedra_submit_job.
Returns: JSON {job_id, status: 'IN_QUEUE'|'IN_PROGRESS'|'COMPLETED'|'FAILED', progress, estimated_completion_at}. Once status is COMPLETED or FAILED, call hedra_get_job for the full result/outputs.
Examples:
Use when: manually polling a long-running job in a loop with your own delay
Don't use when: you just want to wait for completion and get the result in one call (use hedra_wait_for_job instead)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"job_id": "<job_id>"
},
"name": "hedra_get_job_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | The job's id, formatted job_<uuid> — returned by hedra_submit_job. |