Reserve a number before buying
Holds a number for about 30 minutes so it can’t be taken by someone else while you finish checkout. This does not charge your wallet. Pass the returned reservation id to the purchase endpoint to claim the held number.
Authorizations
Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.
Headers
Client-supplied idempotency key on mutating POSTs. Retrying the same request with the same key returns the original result instead of creating a duplicate — send a fresh UUID per logical operation.
Body
The E.164 number to hold (e.g. +14155550100).