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

# Remove Number from Carrier Account

> Agents stop calling from it. Nothing changes in your Telnyx account. Requires `carrier_accounts:manage`.

Agents stop calling from the number. Nothing changes in your Telnyx account: the
number is not released or cancelled there. Requires `carrier_accounts:manage`.

```bash theme={null}
curl -X DELETE https://api.goyappr.com/carrier-accounts/7c1e…/numbers/e2a4… \
  -H "Authorization: Bearer ypr_live_..."
```

```json theme={null}
{ "success": true, "id": "e2a4…" }
```

A number that is not on this account answers `404 NUMBER_NOT_FOUND`.


## OpenAPI

````yaml DELETE /carrier-accounts/{id}/numbers/{phone_number_id}
openapi: 3.1.0
info:
  title: Yappr API
  description: >
    Create and manage AI voice agents, purchase phone numbers, configure tools,
    and initiate calls — all via REST.
  version: 1.0.0
  contact:
    url: https://goyappr.com
servers:
  - url: https://api.goyappr.com
    description: Production
security:
  - apiKey: []
paths:
  /carrier-accounts/{id}/numbers/{phone_number_id}:
    parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
          format: uuid
      - name: phone_number_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
    delete:
      tags:
        - Carrier Accounts
      summary: Remove a number
      description: >-
        Agents stop calling from it. Nothing changes in your Telnyx account.
        Requires `carrier_accounts:manage`.
      operationId: removeCarrierAccountNumber
      responses:
        '200':
          description: Removed
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  id:
                    type: string
                    format: uuid
        '403':
          $ref: '#/components/responses/CarrierAccountsNotEnabled'
        '404':
          description: '`CARRIER_ACCOUNT_NOT_FOUND` or `NUMBER_NOT_FOUND`.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  responses:
    CarrierAccountsNotEnabled:
      description: >
        `CARRIER_ACCOUNTS_NOT_ENABLED` — Yappr has switched calling out through
        your own

        Telnyx account off for this workspace. It is available in every
        workspace, so this

        is only the emergency-off answer; contact Yappr support. Every
        carrier-accounts

        route answers this while it is off (check with

        [GET /carrier-accounts/status](/api-reference/carrier-accounts/status)).
        An API key

        without the route's scope gets a 403 of its own.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Error'
              - type: object
                properties:
                  enabled:
                    type: boolean
                    example: false
          example:
            error: >-
              Calling out through your own Telnyx account is switched off for
              this workspace. Contact Yappr support.
            code: CARRIER_ACCOUNTS_NOT_ENABLED
            enabled: false
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Your Yappr API key (e.g. `ypr_live_...`). Generate one in the dashboard
        under **Settings → API Keys**.

````