Purchase a workspace phone number
Assigns an existing paid rental to a number using country and phoneNumber. New purchases should use owner-session POST /billing/checkout with kind=phone, country=US and phoneNumber. Inventory costs are resolved privately. Poll the operation; an unknown outcome must not be reordered. Required scope: numbers:provision.
Authorizations
Workspace API key or delegated OAuth access token with /v1 resource audience. Administrative routes require the Better Auth browser session instead.
Headers
Reuse for the same logical action and identical body; changed input returns 409.
1 - 200Body
Response
Successful JSON response
1Operation state. Completed sends mean provider acceptance, not recipient delivery. Poll pending or unknown operations; do not resend with a new key.
pending, unknown, completed, failed 1