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

# Eliminar número

> Elimina número del workspace. Ámbito: **phone_numbers:delete**.



## OpenAPI

````yaml /es/phone-numbers-api/api-reference/openapi-phone-numbers.json delete /v1/phone-numbers/{id}
openapi: 3.0.3
info:
  title: 'Notificar API: números de teléfono'
  description: >-
    API para **consultar**, **contratar** (pedidos PIX/tarjeta),
    **regulatorio**, **reemplazo** y **configurar** números del espacio de
    trabajo.


    **Alcances:** `phone_numbers:read` | `phone_numbers:update` |
    `phone_numbers:create` | `phone_numbers:delete`.


    **Autenticación:** encabezado `Authorization: Bearer sk_live_xxxxx` o
    `x-api-key: sk_live_xxxxx`.
  version: 1.0.0
servers:
  - url: https://api.notifique.dev
    description: Producción
security:
  - ntfPhoneBearerAuth: []
  - ntfPhoneApiKeyHeader: []
tags:
  - name: Números de Telefone
    description: Listar, consultar, buscar disponibles y configurar entrada de voz.
  - name: Números de teléfono
paths:
  /v1/phone-numbers/{id}:
    delete:
      tags:
        - Números de teléfono
      summary: Eliminar número
      description: 'Elimina número del workspace. Ámbito: **phone_numbers:delete**.'
      operationId: ntfPhone_deleteNumber
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            example: clxx_phone_1
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                success: true
                data:
                  id: clxx_phone_1
                  deleted: true
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: object
                    additionalProperties: true
                    properties:
                      id:
                        type: string
                        example: clxx_phone_1
                      deleted:
                        type: boolean
                        example: true
        '401':
          description: No autorizado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NtfPhone_ErrorEnvelope'
              example:
                success: false
                error: Bad Request
                code: VALIDATION_ERROR
                message: Campo inválido ou ausente.
        '403':
          description: Prohibido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NtfPhone_ErrorEnvelope'
              example:
                success: false
                error: Bad Request
                code: VALIDATION_ERROR
                message: Campo inválido ou ausente.
        '404':
          description: No encontrado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NtfPhone_ErrorEnvelope'
              example:
                success: false
                error: Bad Request
                code: VALIDATION_ERROR
                message: Campo inválido ou ausente.
      security:
        - ntfPhoneBearerAuth: []
        - ntfPhoneApiKeyHeader: []
components:
  schemas:
    NtfPhone_ErrorEnvelope:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
        message:
          type: string
        code:
          type: string
          example: NOT_FOUND
      example:
        success: false
        error: string
        message: string
  securitySchemes:
    ntfPhoneBearerAuth:
      type: http
      scheme: bearer
      description: 'Clave API sin formato Portador (ej.: sk_live_...).'
    ntfPhoneApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: Alternativa de clave API al portador.

````