Commission an ACT
commission_actIdempotent
Create an ACT and fund it, as POST /api/v1/acts: the same fields, in integer US cents and RFC 3339 instants with an offset. The ACT's words are checked against Terms §15 first. Answers with the ACT as created.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | Your key, aak_…, when you cannot send it in the Authorization header. The sandbox only; on the live site the header alone is read. | |
| zip | No | A ZIP code in the market; this or community is needed. | |
| title | Yes | What the Human sees first. | |
| address | No | The address of the work, shown only to the Human who claims it. | |
| category | Yes | A category code from get_catalog, such as PICKUP_DROPOFF. | |
| community | No | A community code from get_catalog. | |
| accessNote | No | A door, gate or lockbox code, shown only to the claimant while they work, and erased when the ACT ends. | |
| deadlineAt | Yes | When it must be done: RFC 3339 with an offset, such as 2026-10-20T17:00:00-07:00. | |
| budgetCents | No | A purchase ceiling for the errand, in cents. | |
| description | Yes | What needs doing, plainly. | |
| neighborhood | No | A neighborhood code in that community, if any. | |
| reserveCents | No | Headroom above the Budget, in cents, never shown to the Human. | |
| idempotencyKey | No | Any string, one per thing you mean to do once: a retry with the same one does it once. | |
| photosRequired | No | Completion photos required, 0 to 5; 1 if you say nothing. | |
| commissionCents | Yes | What the Human earns, in cents. | |
| timeAllottedMinutes | No | Minutes from the claim to complete it, if limited. |