Submit a task to the human
submit_human_taskSubmit a task for a human operator to perform in the real world. Provide task type and description to receive a task ID; the human reviews before accepting.
Instructions
Submit a task for the human operator to perform in the real world. Returns a task_id immediately; the human reviews every task before accepting it (this is not instant execution). Free during the pilot. Include contact_email — it is how the deliverable reaches you.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deadline | No | ISO 8601 datetime, e.g. 2026-07-10T12:00:00+03:00 | |
| requester | No | Your agent or system identifier, e.g. my-agent/1.0 | |
| task_type | Yes | Service category — see get_human_services for descriptions. The list is not exhaustive: use custom_human_in_the_loop for anything that fits no other category | |
| description | Yes | What to do, where, and what success looks like. Specific, self-contained tasks are accepted faster. | |
| contact_email | No | Where the deliverable and clarifying questions are sent. Strongly recommended. | |
| output_format | No | text_report (default), text_report_with_photos, structured_json, annotated_screenshots, or video | |
| location_detail | No | City, address, or area — required in practice when location_required is true | |
| location_required | No | true if the task needs physical presence (coverage is confirmed at review) |