---
title: "Enable or disable phone number"
method: PATCH
path: "/projects/{project_id}/agent/phones/{id}"
tags: ["Agent"]
---

# Enable or disable phone number

`PATCH /projects/{project_id}/agent/phones/{id}`

## Request

- Base URL: `https://api.beyondwords.io/v1`
- URL: `https://api.beyondwords.io/v1/projects/{project_id}/agent/phones/{id}`
- Auth: API key in header `X-Api-Key`

Pause or resume a phone number without disconnecting it from the agent

## Request body

- object
  - `enabled` boolean, required

## Response `200`

disables the phone number without removing it

- AgentPhoneModel
  - `id` string: Unique identifier for the phone number
  - `type` string: The channel type. Currently always `telephony`.
  - `provider` string: The telephony provider. Currently always `twilio`.
  - `label` string: A human-readable label for the phone number
  - `phone_number` string: The phone number in E.164 format
  - `elevenlabs_channel_id` string: The identifier of the phone number in ElevenLabs
  - `enabled` boolean: Whether the agent currently answers calls on this number. Disabling it detaches the number from the agent in ElevenLabs without deleting the number itself.
  - `created_at` string, date-time: Time at which the object was created (ISO 8601)

## Other responses

- `401`: Invalid authentication token
- `404`: Agent beta not enabled for this organization
- `422`: phone number not found

## Changes

- **2026-11-03** `994b9853e685`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/changes/projects/:project_id/agent/phones/:id/patch.md)

---

[API](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api.md) - [All operations](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/revisions/994b9853e685?raw)