> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Phone Number



## OpenAPI

````yaml latest.yml DELETE /agents/phone-numbers/{id}
openapi: 3.0.1
info:
  title: Cartesia API
  version: 0.0.1
servers:
  - url: https://api.cartesia.ai
    description: Production
security: []
paths:
  /agents/phone-numbers/{id}:
    delete:
      tags:
        - Phone Numbers
      summary: Delete Phone Number
      operationId: phone_numbers_delete
      parameters:
        - $ref: '#/components/parameters/CartesiaVersionHeader'
        - name: id
          in: path
          description: >-
            The phone number ID.

            Twilio numbers can be deleted while assigned. Cartesia disconnects
            the agent and attempts to clear the Twilio webhook, but cleanup
            failures do not block deletion. Unassign Cartesia-managed and SIP
            trunk numbers first. Deleting a Cartesia-managed number releases it
            permanently.
          required: true
          schema:
            type: string
      responses:
        '204':
          description: Phone number deleted.
        '400':
          description: >-
            A Cartesia-managed or SIP trunk number is still assigned, or
            provider cleanup failed.
        '404':
          description: Phone number not found.
      security:
        - APIKeyAuth: []
components:
  parameters:
    CartesiaVersionHeader:
      name: Cartesia-Version
      in: header
      description: API version header.
      required: true
      schema:
        type: string
        format: date
        example: '2026-08-14'
        default: '2026-08-14'
        enum:
          - '2026-08-14'
  securitySchemes:
    APIKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Cartesia API key (`sk_car_...`). Get one at
        [play.cartesia.ai/keys](https://play.cartesia.ai/keys).
      x-default: $CARTESIA_API_KEY

````