---
title: "Disable Twilio phone number"
method: POST
path: "/v1/integrations/twilio/phone-numbers/disable"
tags: ["Credentials"]
---

# Disable Twilio phone number

`POST /v1/integrations/twilio/phone-numbers/disable`

## Request

- Base URL: `https://api.skyvern.com`
- URL: `https://api.skyvern.com/v1/integrations/twilio/phone-numbers/disable`
- Auth: API key in header `x-api-key`

Disable SMS forwarding for a phone number registered in the current organization.

## Request body

- DisablePhoneNumberRequest
  - `phone_number_id` string, required

## Response `200`

Successful Response

- OrganizationPhoneNumberResponse: Safe phone-number metadata without provider routing or cost secrets.
  - `phone_number_id` string, required
  - `organization_id` string, required
  - `sms_config_id` string, required
  - `phone_number` string, required
  - `provider` string, required
  - `credential_id` string, nullable
  - `price_cents` integer, nullable
  - `billing_exempt` boolean
  - `status` 'active' | 'disabled' | 'released' | 'quarantined' | 'provisioning' | 'quarantining' | 'releasing' | 'surrendering' | 'reversal_pending', required
  - `cancel_at` string, date-time, nullable
  - `quarantined_until` string, date-time, nullable
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `deleted_at` string, date-time, nullable

## Other responses

- `404`: The phone number was not found
- `409`: The phone number changed during the disable operation
- `422`: Request validation failed
- `502`: The Twilio provider request failed
- `503`: The Twilio provider rate limit was reached

## Changes

- **2026-10-27** `dc7de12b8e80`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/integrations/twilio/phone-numbers/disable/post.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) - [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/revisions/64479cb160ff?raw)