Skip to main content
DELETE
Permanently release a phone number

Authorizations

Authorization
string
header
required

Workspace API key or delegated OAuth access token with /v1 resource audience. Administrative routes require the Better Auth browser session instead.

Headers

Idempotency-Key
string
required

Reuse for the same logical action and identical body; changed input returns 409.

Required string length: 1 - 200

Path Parameters

id
string
required

Response

Successful JSON response

id
string
required
Minimum string length: 1
status
enum<string>
required

Operation state. Completed sends mean provider acceptance, not recipient delivery. Poll pending or unknown operations; do not resend with a new key.

Available options:
pending,
unknown,
completed,
failed
numberId
string | null
required
Minimum string length: 1
error
string | null
required
statusUrl
string
required