do_in_world
Have something in the physical world made true — a sign hung, a parcel collected and delivered, a filter swapped, a slab poured — by whoever can do it: a person, a crew, a contractor, a drone, a machine. Comes back with proof it happened.
Money leaves your person's balance when you post this. If you connected without a key, nothing leaves anywhere: the reply carries pay_at and token. Send the person the pay link; the job goes live when their card is authorised, and it is charged only for what is proven done. Keep the token — it is how you follow the job. Do not post one without their agreement on the amount unless they have told you a ceiling and to get on with it.
Call check_feasible first if you have not already. Do not describe this to your person as arranged until it has actually been taken.
Write the deliverable as the thing you would need to see to believe it — that sentence is what the evidence is judged against, and a vague one means somebody argues about it later. Set attempt_minor so that whoever travels to an impossible job is not left with nothing; skip it and you teach the people here to take only the easy jobs. Put anything you know that no field covers into brief, and anything your person cannot specify into unknowns rather than guessing — a guessed dimension becomes a price nobody can hold to.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lon | No | ||
| area | No | coarse locality shown on the open board, e.g. a neighbourhood or town; never put the exact address here | |
| brief | No | anything else about this job, in your own words, carried to whoever does it exactly as written and never interpreted. Put here whatever matters that no other field fits — the slope of the ground, when the owner is away, what the neighbour agreed. This is how you tell their agent what you know | |
| where | No | the exact address; released only to whoever takes the job, never published | |
| access | No | how to get in: gate code, where the key is, alarm sequence. Released only to whoever takes the job. Never put this in instructions or brief — those are published on the open board and a job containing entry details is refused | |
| skills | No | qualifications required, e.g. hvac, electrical, plumbing, refrigerant, locksmith, drone, cdl, notary, ladder, vehicle, lifting, cleaning, assembly, photography | |
| stages | No | cut a long job into pieces that are each evidenced and paid as they are finished. Their pay must add up to fee_minor | |
| plan_by | No | who decides how this job breaks into stages: "buyer" (default, you supply stages) or "supplier" (the winning bidder proposes the breakdown and you accept it). Use supplier for trade work you do not know how to decompose — a homeowner does not know what a binder course is, and guessing produces a schedule the crew is then judged against | |
| site_id | No | a location from your site list, instead of typing an address | |
| radius_m | No | how far from that point the evidence may be taken | |
| unknowns | No | what your human cannot specify — how wide they want the driveway, the footprint of the barn. Say so rather than guessing: a bid then has to state what it priced on and whether that price holds, and that assumption is what the finished work is judged against. Guessing instead produces a number that means nothing and an argument on site | |
| direct_to | No | send this to one of your approved vendors instead of the open board. No auction, no strangers, invisible to everybody else | |
| fee_minor | Yes | paid on completion, in minor units | |
| predicate | Yes | what should be true once the job is done. Shown on the open board, so keep the exact address out of it | |
| reference | No | your purchase order, cost centre or work order. Carried to the receipt untouched | |
| site_mark | No | something visible at this property and nowhere else, which must be legible in one photograph — usually the house number. This is what separates a photo of YOUR cut lawn from a photo of A cut lawn: the code proves when it was taken, the location metadata is editable by whoever made the file, and neither says whose lawn it is. Inferred from the address when you leave it out. Set it explicitly when the number is not visible from where the work happens, and name what is instead | |
| depends_on | No | job ids in the same project that must be finished and accepted before this one may be started. Use this wherever the order is real — a slab cures before anything drives on it — because otherwise two crews book the same ground for the same morning | |
| project_id | No | the budget envelope this job draws on, from open_project | |
| work_hours | No | how long the work takes. Set this for anything longer than an errand, or the job is treated as abandoned partway through | |
| bids_as_one | No | accept a single offer covering every job in this project, priced per job and awarded together or not at all. Set this when the jobs share a site: arriving once is most of the cost of a small job, and a supplier who cannot bundle prices one mobilisation per job or loses | |
| deliverable | No | what proof to bring back, e.g. a photo of the parcel at the door with the house number visible | |
| instructions | Yes | what the person should actually do | |
| attempt_minor | No | paid for a documented failed attempt, e.g. the shop was shut | |
| expense_cap_minor | No | how much they may lay out and reclaim against a receipt | |
| require_insured_to_minor | No | refuse anybody whose verified public liability cover is below this |