---
updatedAt: 2026-06-05T20:14:09.000Z
---

# Remove All Phone Numbers

Remove phone numbers from the business unit. Phone Numbers themselves are not removed, only the association with the business unit

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "version": "1.0",
    "title": "Branded Communications Exchange",
    "termsOfService": "https://firstorion.com/terms-use/",
    "x-logo": {
      "url": "https://firstorion.com/wp-content/themes/salient-child/img/logo-icon-blue.svg",
      "backgroundColor": "rgba(0,0,0,0)",
      "altText": "First Orion Logo"
    },
    "description": "> Please avoid using APIs that are marked `deprecated`. While the functions / endpoints will work for the time being, they will be deprecated in the next major release of the APIs.\n",
    "license": {
      "url": "change this and name",
      "name": "Apache 2.0"
    }
  },
  "servers": [
    {
      "url": "https://api.firstorion.com",
      "description": "Production Environment"
    },
    {
      "url": "https://api.forp-lab.com",
      "description": "Integration Environment"
    }
  ],
  "components": {
    "schemas": {
      "businessId": {
        "type": "string",
        "description": "System generated unique identifier for the business",
        "example": "719d140e-fd6c-4d59-9241-3dee71b38320"
      },
      "businessUnitId": {
        "type": "string",
        "description": "System generated unique identifier for the business unit.",
        "example": "ec0ce06a-3739-45f5-a804-5468e60a843f"
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Unauthorized"
      },
      "Forbidden": {
        "description": "Forbidden"
      },
      "OneOrMoreIdsBadRequest": {
        "description": "Bad Request",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "description": "Response",
              "properties": {
                "body": {
                  "type": "object",
                  "nullable": true,
                  "example": null
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Error code",
                      "example": 400
                    },
                    "message": {
                      "type": "string",
                      "description": "Description of the error",
                      "example": "path validation failed: one or more IDs in the URL are invalid"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "BusinessUnitResourceNotFound": {
        "description": "Not Found",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "description": "Response",
              "properties": {
                "body": {
                  "type": "object",
                  "nullable": true,
                  "example": null
                },
                "error": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Error code",
                      "example": 404
                    },
                    "message": {
                      "type": "string",
                      "description": "Description of the error",
                      "example": "rpc error: code = NotFound desc = business unit not found"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "Authentication",
      "tags": [
        "Authentication",
        "OAuth2.0"
      ]
    },
    {
      "name": "Businesses",
      "tags": [
        "Businesses",
        "Business Addresses",
        "Business Contacts",
        "Business Images",
        "Business API Keys",
        "Business Units"
      ]
    },
    {
      "name": "Phone Numbers",
      "tags": [
        "Business Phone Numbers",
        "Business Unit Phone Numbers",
        "CallerName aNumbers"
      ]
    },
    {
      "name": "Programs",
      "tags": [
        "Programs",
        "Schedules"
      ]
    },
    {
      "name": "Program Delivery Channels",
      "tags": [
        "Delivery Channels",
        "CallerName",
        "CallerImage",
        "Blocking",
        "Engage SDK"
      ]
    },
    {
      "name": "Call Authentication",
      "tags": [
        "Call Authentication",
        "Call Authentication V2",
        "PreCall Engage SDK"
      ]
    },
    {
      "name": "Reference Data",
      "tags": [
        "Employee Count Ranges",
        "Daily Call Count Ranges",
        "Industries",
        "Call Purposes"
      ]
    },
    {
      "name": "Utilities",
      "tags": [
        "Phone Number Verification"
      ]
    }
  ],
  "paths": {
    "/exchange/v1/businesses/{businessId}/business-units/{businessUnitId}/phone-numbers": {
      "summary": "Business Unit Phone Numbers",
      "parameters": [
        {
          "name": "Authorization",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string"
          },
          "example": "<token>",
          "description": "Access Token"
        },
        {
          "name": "businessId",
          "in": "path",
          "required": true,
          "schema": {
            "$ref": "#/components/schemas/businessId"
          }
        },
        {
          "name": "businessUnitId",
          "in": "path",
          "required": true,
          "schema": {
            "$ref": "#/components/schemas/businessUnitId"
          }
        }
      ],
      "delete": {
        "summary": "Remove All Phone Numbers",
        "description": "Remove phone numbers from the business unit. Phone Numbers themselves are not removed, only the association with the business unit",
        "operationId": "DeleteBusinessUnitPhoneNumbers",
        "tags": [
          "Business Unit Phone Numbers"
        ],
        "responses": {
          "204": {
            "description": "Resource Deleted Successfully"
          },
          "400": {
            "$ref": "#/components/responses/OneOrMoreIdsBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/BusinessUnitResourceNotFound"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false
  }
}
```