Cartesia 番号をプロビジョニング

curl --request POST \ --url https://api.cartesia.ai/agents/phone-numbers/provision \ --header 'Authorization: Bearer <token>' \ --header 'Cartesia-Version: <cartesia-version>' \ --header 'Content-Type: application/json' \ --data ' { "label": "<string>", "agent_id": "<string>" } '

{ "id": "pn_abc123", "label": "Support line", "number": "+14155551234", "agent": { "id": "agent_abc123", "name": "Customer support" }, "created_at": "2026-03-01T00:00:00Z", "updated_at": "2026-03-01T00:00:00Z" }

承認

Authorization

string

header

必須

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

ヘッダー

Cartesia-Version

enum<string>

必須

API version header.

利用可能なオプション:

2026-03-01

例:

"2026-03-01"

ボディ

application/json

Request body for provisioning a new Cartesia-managed phone number.

label

string

必須

A human-readable name for the phone number.

agent_id

string

Optionally assign an agent to answer inbound calls to this number. Omit to keep the number outbound-only.

レスポンス

Phone number provisioned.

The number supports inbound calls and outbound calls to US numbers only

string

必須

Unique identifier for the phone number.

number

string

必須

The phone number in E.164 format (e.g. +14155551234).

agent

object

必須

The agent that answers inbound calls to this number, or null if unassigned

Show child attributes

created_at

string<date-time>

必須

UTC timestamp when the phone number was created.

updated_at

string<date-time>

必須

UTC timestamp when the phone number was last updated.

label

string | null

A human-readable name for the phone number.