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

# Excluir número

> Remove número do workspace. Escopo: **phone_numbers:delete**.



## OpenAPI

````yaml /phone-numbers-api/api-reference/openapi-phone-numbers.json delete /v1/phone-numbers/{id}
openapi: 3.0.3
info:
  title: Notifique API. Números de Telefone
  description: >-
    API para **consultar**, **contratar** (pedidos PIX/cartão), **regulatório**,
    **substituição** e **configurar** números do workspace.


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


    **Autenticação:** cabeçalho `Authorization: Bearer sk_live_xxxxx` ou
    `x-api-key: sk_live_xxxxx`.
  version: 1.0.0
servers:
  - url: https://api.notifique.dev
    description: Produção
security:
  - ntfPhoneBearerAuth: []
  - ntfPhoneApiKeyHeader: []
tags:
  - name: Números de Telefone
    description: Listar, consultar, buscar disponíveis e configurar voz de entrada.
paths:
  /v1/phone-numbers/{id}:
    delete:
      tags:
        - Números de Telefone
      summary: Excluir número
      description: 'Remove número do workspace. Escopo: **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: Não 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: Proibido.
          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: Não 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: 'API Key no formato Bearer (ex.: sk_live_...).'
    ntfPhoneApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key alternativa ao Bearer.

````