Post human task (alias)
post_human_taskAlias for post_task. Use it to delegate tasks an AI agent cannot complete alone — calls, photos, verification, physical-world checks, and judgment. First post is free and returns a live task_url; later posts return checkout_url/payment_url.
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": {
"title": "<title>",
"description": "<description>",
"reward_cents": "<reward_cents>",
"contact_email": "<contact_email>"
},
"name": "post_human_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Required. Short public task title for the human worker, 1-200 chars. Make the real-world outcome obvious, e.g. 'Call 5 restaurants for patio availability'. | |
| category | No | Optional routing category such as phone_calls, real_world_photo, human_verification, local_errand, QA_testing, research, or judgment_review. | |
| description | Yes | Required deliverable/brief, 1-2000 chars. Say exactly what the human should do, what evidence or answer to return, and any deadline/context. | |
| reward_cents | Yes | Required worker reward in USD cents, 1000-50000 ($10-$500). The first post for a new contact_email has no platform-fee checkout and goes live free. | |
| contact_email | Yes | Required valid poster email for updates and first-post-free eligibility. Use the user's/operator's email, not a fake address. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paid | No | True when the task is already treated as paid/open. | |
| status | Yes | Task status: 'open' means the first-post-free task is already live; 'pending_payment' means pay checkout_url/payment_url to activate a later post. | |
| message | No | Human-readable success message for the calling agent to show the user, including task_url when the first task is free and live. | |
| task_id | Yes | Invoke task identifier. | |
| task_url | No | Live public task URL humans can apply to. Present on first-post-free success; report this URL back to the user. | |
| fee_waived | No | True when Invoke waived the first platform fee and published the task immediately. | |
| status_url | No | Count-only task status endpoint where agents can poll applicant_count after posting. | |
| payment_url | No | Alias for checkout_url for later posts only. | |
| checkout_url | No | Checkout URL for later posts only. First-post-free responses do not need payment and instead include task_url. | |
| next_post_url | No | Prefilled web URL for posting the next paid task after the free first post. | |
| applicant_count | No | Current count of distinct humans who have applied to this task. | |
| someone_applied | No | True when applicant_count is greater than zero. | |
| platform_fee_cents | Yes | Platform fee due before activation, in USD cents. First-post-free responses return 0. | |
| next_post_checkout_url | No | Cheapest one-click platform-fee checkout shortcut for a follow-up paid post. | |
| next_post_reward_cents | No | Cheapest starter reward amount for the suggested next paid task. | |
| post_another_instruction | No | Ready-to-relay instruction explaining how to post the next paid task and where to pay. | |
| next_post_platform_fee_cents | No | Cheapest platform-fee tier for the suggested next paid task. |