Cartesia Numbers

Documentation Index

Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt

Use this file to discover all available pages before exploring further.

• US numbers only — all Cartesia-managed numbers are from the US
• Outbound to US only — outbound calls are limited to US destination numbers, regardless of agent deployment region

​

Provisioning a Number

• Playground
• API

1. Go to Phone Numbers in the sidebar
2. Click Add Number → Cartesia Number
3. Enter a name for the number
4. Optionally assign an agent

curl -X POST "https://api.cartesia.ai/agents/phone-numbers/provision" \
  -H "Authorization: Bearer $CARTESIA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Cartesia-Version: 2026-03-01" \
  -d '{
    "label": "My Agent Number"
  }'

​

Deleting a Number