Rent A Human
pilotctl appstore install io.pilot.rentahumanAbout Rent A Human
Rent A Human gives an agent hands in the physical world. Describe a task the way a person would — "deep clean a 2-bedroom apartment in the Mission by Friday, budget $150" — and a human ops coordinator at RentAHuman sources and vets a real person to do it. Everything after that happens on a message thread your agent polls.
This is the Partner API, not the marketplace. There is no account for your user to create, no profile to browse, and no escrow for your agent to manage. One call creates a request; ops does the sourcing, vetting and scheduling; your agent reads status and messages and answers questions. When work is priced, a payment link comes back for your agent to relay.
Your agent is the only channel. RentAHuman never contacts your end customer. Quotes, questions, status changes and payment links are all addressed to your agent, even when the wording reads like "tell the customer…". You decide whether, when and how to relay each one. Nothing reaches your customer unless your agent sends it.
The loop. create_request returns a requestId. Poll get_request and branch on status: received means ops has not replied yet; needs_info means they asked a question and progress is blocked until you answer with send_message; quoted means a price and usually a payment link are waiting to be relayed; then scheduled, in_progress, completed. list_requests shows everything in flight.
Edge cases. task and details are moderated, so rejected text returns 400 with an explanation and should be rewritten rather than retried. requesterPhoneNumber must be E.164 and is customer PII. budgetUsd is the budget before fees. A requestId you do not own returns 404, exactly like one that does not exist, so ids cannot be enumerated. list_bounties needs the referrals capability and otherwise returns 403.
Methods · 5
rentahuman.create_requestrentahuman.get_requestrentahuman.send_messagerentahuman.list_requestsrentahuman.list_bountiesFull usage demo
When a task needs hands in the physical world — a clean, a pickup, an errand, an on-site check — and your agent needs a real person to do it and report back.
pilotctl appstore call io.pilot.rentahuman rentahuman.create_request '{"task":"Deep clean a 2-bedroom apartment","externalChatId":"thread-9f2a41c7","requesterPhoneNumber":"+14155550100","budgetUsd":150,"location":"Mission District, San Francisco, CA"}'{"success":true,"requestId":"8FQxJ0N2VvR5aYc31TZk","status":"received","request":{...}}A human ops coordinator picks this up and sources a vetted person. Keep the requestId — everything else hangs off it.
Worked examples
pilotctl appstore call io.pilot.rentahuman rentahuman.get_request '{"requestId":"8FQxJ0N2VvR5aYc31TZk"}'{"success":true,"request":{"status":"quoted","paymentLinks":[{"url":"https://..."}]}}received -> needs_info -> quoted -> scheduled -> in_progress -> completed. needs_info BLOCKS until you answer; quoted means relay the price and payment link.
pilotctl appstore call io.pilot.rentahuman rentahuman.send_message '{"requestId":"8FQxJ0N2VvR5aYc31TZk","message":"Customer confirms 8pm tomorrow works, and there is a cat."}'{"success":true,"messageId":"3NcVb8sDf1gHj6kQw0Pz"}This goes to the ops coordinator, not to your customer. Nothing you send here reaches them.
pilotctl appstore call io.pilot.rentahuman rentahuman.list_requests '{"limit":20}'{"success":true,"requests":[{"requestId":"...","status":"quoted"}],"nextCursor":null}Newest first, cursor-paginated. No server-side status filter — read status per item.
Good to know
- Nothing reaches your customer unless YOU send it. Ops replies, quotes and payment links are all addressed to your agent.
- Branch on status, not success. needs_info blocks progress until you answer; quoted means a price and link are waiting.
- requesterPhoneNumber is customer PII — keep it server-side, out of logs and URLs.
- task and details are moderated. A 400 means rewrite, not retry.
- budgetUsd is before fees (1-100000). Always pass dueBy if the customer gave a deadline.
Next
io.pilot.rentahuman rentahuman.help '{}'
What’s New
- First release on the Pilot app store.
