---
title: "Update Workspace Phone Number"
method: PATCH
path: "/v2/phone-numbers/{phone_number_id}"
tags: ["v2", "phone-numbers"]
---

# Update Workspace Phone Number

`PATCH /v2/phone-numbers/{phone_number_id}`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v2/phone-numbers/{phone_number_id}`
- Auth: HTTP bearer

Update phone number settings (twilio_sid, elevenlabs_phone_number_id).

For status changes (activate/deactivate), use POST /{id}/status instead.
For deletion, use DELETE /{id}.

## Path parameters

- `phone_number_id` string, required

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- UpdateWorkspacePhoneNumberRequest: Request to update a workspace phone number settings
  - `twilio_sid` string, nullable
  - `elevenlabs_phone_number_id` string, nullable
  - `sms_enabled` boolean, nullable
  - `whatsapp_enabled` boolean, nullable

## Response `200`

Successful Response

- WorkspacePhoneNumberResponse: Workspace phone number data returned from API
  - `id` string, required
  - `workspace_id` string, required
  - `organization_id` string, required
  - `phone_number` string, required
  - `twilio_sid` string, nullable
  - `elevenlabs_phone_number_id` string, nullable
  - `voice_provider` string
  - `is_active` boolean, required
  - `sms_enabled` boolean
  - `whatsapp_enabled` boolean
  - `whatsapp_sender_sid` string, nullable
  - `whatsapp_sender_status` string, nullable
  - `whatsapp_sender_error` string, nullable
  - `whatsapp_registered_at` string, date-time, nullable
  - `area_code` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `country_code` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `deleted_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

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