Request a robot lease
request_leaseRequest a time-boxed rental of an available robot. Select an offered access_type or omit it for the primary rental arrangement. Personnel-operated and equipment-only rentals require empty granted_permissions and mint no control token. Remote controls require configured integration and permitted scope; remote_teleoperation uses supervisory (command) mode unless you pass control_mode teleop and the listing offers it. The window must fit the listing rental_availability; for on_request listings, inquire first and pass the promise_id of an accepted window. The request waits for operator approval (REQUESTED); poll get_lease, then activate once CONFIRMED.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"listing_id": "<listing_id>",
"window_start": "<window_start>",
"window_end": "<window_end>",
"granted_permissions": "<granted_permissions>"
},
"name": "request_lease"
}
}Input 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. | |
| access_type | No | ||
| 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 | ||
| window_start | Yes | ISO 8601 datetime. | |
| granted_permissions | Yes | Subset of the listing's permissions_offered. |