List phone numbers
List the phone numbers provisioned in a workspace, with provider, status, friendly name, the monthly price in cents, when it was bought, and the id of the agent it answers for (null when unassigned). Assign one to an agent with assign_phone_number.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Path Parameters
Workspace slug (GET /me lists yours).
Query Parameters
Items per page, 1 to 200. Default 50.
1 <= value <= 200The next_cursor of the previous page.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/workspaces/string/phone-numbers"{
"data": [
{
"id": "string",
"phoneNumber": "string",
"property1": null,
"property2": null
}
],
"has_more": true,
"next_cursor": "string"
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Route a number to an agent POST
Assign a workspace phone number (by its id from list_phone_numbers) to an agent, so calls to that number reach the agent. For a number on our carrier this also points it at this environment's voice connection, so a number that previously routed elsewhere (another env, an old local tunnel, an outbound-only caller ID) starts ringing here, that repoint is what makes the assignment real, so it runs before the binding and the whole call fails if it can't. This is also the repair for the connection drift reconcile_phone_numbers reports.
Remove a phone number DELETE
Remove a phone number from a workspace: stop its Stripe rental billing, unassign it from any agent, and drop the workspace's claim. This does NOT release the number to the provider. It stays owned by Vertical AI and deletion-locked, so support can hand it back to this workspace or another one later. Same retain-don't-release path as the Remove button on the workspace's Phone numbers page. Releasing a number to the provider's public pool has no MCP tool on purpose; that stays a human action in the app. Use this too to clear a workspace row whose number no longer exists at the carrier (reconcile_phone_numbers reports those). Destructive: pass confirm: true.