Start a rent
start_rentStarts renting one listed name for a term (12, 6 or 1 month) and returns an approval_url for the human to open: they sign in (an email code, then a passkey or authenticator app), pass the identity check, sign the lease and pay by card, and the fixed-term lease starts on payment with no refunds after activation; names are rented for business or other commercial use only. Call it once the user has chosen the name and term. A rented or unheld name answers taken or not_listed with listed alternatives; a mandate (pre-authorized agent rent) is not available yet.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | The domain name as the user gave it: a URL or a bare host both work. | |
| client | No | The agent platform or client, free text, recorded on the intent. | |
| mandate | No | A pre-authorization from the human for an agent-completed rent. Not available yet: the answer is mandate_unavailable and approval_url still works. | |
| term_months | No | The term: 12, 6 or 1 month. The 12 month rate is the listed rate; shorter terms cost more per month. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | ||
| status | Yes | ||
| monthly | Yes | ||
| intent_id | Yes | ||
| next_step | Yes | ||
| expires_at | Yes | ||
| term_months | Yes | ||
| alternatives | Yes | ||
| approval_url | Yes | ||
| monthly_cents | Yes |