Sign in

v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Phone Numbers

Remove phone numbers from a DIR

Deregister phone numbers from a DIR. The enterprise is resolved server-side from the DIR id. Returns a partial-success envelope.

delete/dir/{dir_id}/phone_numbers

Path parameters

dir_idstring uuid required
Example:16635d38-75a6-4481-82e8-69af60e05011

The DIR id. Lowercase UUID.

Request body

phone_numbersstring[] required

Example request

{
  "phone_numbers": [
    "+19493253498"
  ]
}

Response

Bulk-delete response. Inspect both deleted and errors.

datastring[] required

Phone numbers that were successfully soft-deleted. Bare E.164 strings.

Example response

{
  "data": [
    "+19493253498"
  ],
  "meta": {
    "errors": [
      {
        "code": "not_associated",
        "detail": "Phone number not associated with this DIR.",
        "phone_number": "+19493253498",
        "title": "Phone number not associated"
      }
    ]
  }
}