Sign in

v27

latestOpenAPI 3.1.0LicenseRef-Proprietaryraw.githubusercontent.com2026-07-21173076.1 KB
Workers

Retrieve a worker

Retrieve the current worker state and messages from its most recent task (or a specific task via taskId).

get/api/workers/{workerId}

Path parameters

workerIdstring required
Example:t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM

Worker id returned by the create worker endpoint.

Query parameters

taskIdstring

Return the worker state and messages for a specific task instead of the most recent one.

Return the worker state and messages for a specific task instead of the most recent one.

Response

Worker object.

idstring required
object'worker' required
created_atinteger nullable required
status'running' | 'completed' | 'pending' required
runningboolean required
{"stackTrail":"components:schemas:Worker:properties:error","oasType":"schema","type":"unknown"}
{"stackTrail":"components:schemas:Worker:properties:incomplete_details","oasType":"schema","type":"unknown"}
metadataobject required
output_textstring required
structured_outputobject nullable required
urlstring required

Web URL of the worker in the Handinger dashboard.

Example response

{
  "url": "https://v3.handinger.com/worker/wrk_vk81XUHKHG-qr4"
}