Skip to main content
DELETE
Release a number

Authorizations

Authorization
string
header
required

Use Authorization: Bearer pyai_live_... (or pyai_test_...).

Path Parameters

id
string
required

Response

Released

object
string
Example:

"telephony.number"

id
string
Example:

"pn_..."

phone_number
string

E.164.

Example:

"+14155550123"

country
string
Example:

"US"

area_code
string | null
Example:

"415"

capabilities
object
agent_id
string | null

Agent that answers inbound calls to this number.

recording
boolean

Whether PyAI recording is enabled for the number.

monthly_cost_cents
integer
status
enum<string>
Available options:
active,
released
created_at
integer

Unix ms.

released_at
integer | null

Unix ms.