rigshare_create_booking
Create an equipment booking on RIGShare. The server computes prices from equipment rates, verifies identity, holds a security deposit, and applies a budget cap.
Instructions
REQUIRES API KEY (bookings:write scope). Creates a new RIGShare booking for the authenticated user. Server computes all prices from the equipment's canonical rates — client-side price hints are ignored. Enforces identity verification, security deposit hold, and a daily/monthly budget cap configured on the API key. Returns confirmation code + booking ID on success. Use rigshare_list_my_bookings to check status afterwards.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| equipment_id | Yes | From rigshare_search_equipment or rigshare_get_equipment. | |
| start_date | Yes | ISO-8601 start datetime. | |
| end_date | Yes | ISO-8601 end datetime. Must be after start_date. | |
| duration_type | Yes | Determines which rate is used. Must match a rate the equipment actually offers (e.g., use HOURLY only when equipment has a rateHourly). | |
| pickup_type | No | Default REMOTE_ACCESS for robotics/AI equipment. Use SELF_PICKUP or OWNER_DELIVERY for construction equipment. | REMOTE_ACCESS |
| idempotency_key | No | Optional. If provided, repeated calls with the same key within 5 minutes return the same booking instead of creating duplicates. |