Request a robot lease
request_leaseRequest a time-boxed lease on a listing. Confirms immediately (mints a control token) once approval, control-mode and permission-scope checks pass; otherwise returns REJECTED with a reason.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| currency | No | Payments are not enabled yet: must be null or omitted. | |
| body_kind | No | Which of the listing's bodies to lease; required when it offers both. | |
| listing_id | Yes | ||
| promise_id | No | Redeem a promise of lease (from accept_inquiry): the window must lie within the promised window. | |
| window_end | Yes | ISO 8601 datetime, after window_start. | |
| agreed_price | No | Payment isn't handled through the API (pricing and payouts: hello@getbody.md): must be null or omitted (else 400 payment_arranged_by_getbody). | |
| control_mode | No | supervisory | |
| window_start | Yes | ISO 8601 datetime. | |
| granted_permissions | Yes | Subset of the listing's permissions_offered. |