Sign in

v27

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

Create a task

Run a new task against an existing worker and wait for the result. Send a taskId of a prior task to add a follow-up turn instead of starting a fresh task. Send multipart/form-data to attach files; the bytes are bootstrapped into the worker's workspace before the task starts. The task runs to completion on the server even if the connection drops; subscribe to task webhooks for long-running tasks.

post/api/tasks

Request body

inputstring required
budget'low' | 'standard' | 'high' | 'unlimited'

Compute budget the worker is allowed to spend on the task. Defaults to standard.

taskIdstring

Optional client-provided task id. Reuse this id to add turns to an existing task.

workerIdstring

Worker id the task belongs to. If omitted, a new worker is created on-the-fly using the input as instructions.

Example request

{
  "input": "What's the weather today in Barcelona?",
  "budget": "standard",
  "taskId": "tsk_2Z-YWz3hFq6VlW",
  "workerId": "wrk_vk81XUHKHG-qr4"
}

Response

Worker object reflecting the final task result.

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"
}