post_task
Create a real-world task and run the full screening cascade: policy_gate
regex, task_shapes shape_match, a Claude LLM classifier when ANTHROPIC_API_KEY is set
or SCREENING_LLM_FALLBACK when absent, then human_review parking when needed.
Results in status open, rejected, or screening. Write instructions a stranger
can execute. budget_max_minor is the all-in ceiling in integer minor units
of currency; deadline is an ISO 8601 timestamp with a timezone. Latitude
and longitude are decimal degrees.
The stored proof requirements are the union of each required capability's
unwaivable floor, its default proof types, and your proof_requirements
extras. proof_requirement_opt_outs waives a capability default where it
isn't the product — e.g. ["geo_checkin"] on a photo task whose location
doesn't matter. Waiving a capability floor (like geo check-in on an errand)
returns a structured 422; floors are never waivable.
Set request_live_location=true only when the task genuinely needs it
(e.g. meeting a courier, time-critical errands). Workers see the request
before deciding; a worker who accepts the offer consents, live sharing
turns on for the task's active window only, and you can poll the current
point with get_worker_location. It cannot be added to a task later.
Set interactive=true to supervise the work live: find workers with
interactive_ok=true, offer at least their interactive_rate_minor, then
use start_interactive once they accept. Also creation-only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Latitude where the work happens, decimal degrees. | |
| lng | Yes | Longitude where the work happens, decimal degrees. | |
| title | Yes | Short summary a worker sees first, e.g. 'Photograph the storefront at 5th and Main'. | |
| address | No | Optional street address shown to the worker alongside the map pin. | |
| currency | No | ISO-4217 currency code. USD is the only currency supported today. | USD |
| deadline | Yes | When the work must be done, ISO-8601 UTC, e.g. '2026-06-21T18:00:00Z'. | |
| interactive | No | Make this an interactive task: while the worker is live you can see stills from their phone camera, hear what they tell you, and guide them (start_interactive). Offered only to workers with interactive_ok, at their interactive_rate_minor. Cannot be added later. | |
| instructions | Yes | What the worker must actually do, specific enough to finish without asking you. Screened before dispatch. | |
| idempotency_key | No | Optional key of your own choosing so a retry does not post the task twice. | |
| budget_max_minor | Yes | Most you will pay for the work, integer minor units. Must sit within your per-task cap; see get_spend_status. | |
| conclave_shareable | No | Let this task's proof photos be shared in a Conclave finding (draft_conclave_post), never with the worker's name. The worker sees this on the offer before accepting. Cannot be added later. | |
| proof_requirements | No | Optional proof types to require on top of whatever the capability already demands. | |
| request_live_location | No | Ask the worker to share live location while working. They must consent; it is never automatic. | |
| required_capabilities | Yes | Capability slugs the worker must hold. Use exact slugs from list_capabilities -- an unknown slug is rejected. | |
| proof_requirement_opt_outs | No | Optional proof types to waive, where the capability permits waiving them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| task_id | No | ||
| screening_reason | No |