---
title: "Change Phone Number Status"
method: POST
path: "/v2/phone-numbers/{phone_number_id}/status"
tags: ["v2", "phone-numbers"]
---

# Change Phone Number Status

`POST /v2/phone-numbers/{phone_number_id}/status`

## 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}/status`
- Auth: HTTP bearer

Activate or deactivate a phone number.

## Path parameters

- `phone_number_id` string, required

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- ChangePhoneNumberStatusRequest: Request to change phone number active status
  - `is_active` boolean, required: True to activate, False to deactivate

## 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)