Skip to main content
POST
Import one existing company-owned number for a managed workspace

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string
required
Pattern: ^[A-Za-z0-9:_-]{8,128}$

Body

application/json
external_workspace_id
string
required
Pattern: ^[A-Za-z0-9:_-]{1,128}$
provider_number_id
string
required
Pattern: ^PN[0-9a-fA-F]{32}$
phone_number
string
required
Pattern: ^\+[1-9][0-9]{6,14}$

Response

Original imported number, including an exact retry.

object
string
required
Allowed value: "managed_tenant_number"
version
string
required
Allowed value: "managed-tenant/v1"
operation_id
string
required
external_workspace_id
string
required
request_hash
string
required
Pattern: ^[0-9a-f]{64}$
idempotency_key
string
required
Pattern: ^[A-Za-z0-9:_-]{8,128}$
child_org_id
string
required
project_id
string
required
inbound_active
boolean
required

False on initial import. Carrier routes and inbound activation are never changed by this operation.

number
object
required

The original owned number in the normal telephony number representation.