Skip to main content
DELETE
/
v1
/
organization
/
phone-numbers
/
{phoneNumberId}
cURL
curl --request DELETE \
  --url https://api.buildwithchirp.com/v1/organization/phone-numbers/{phoneNumberId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "phoneNumberId": "ph_2DbBs7GWhGvVNJGrDXr5RG0mBWI",
  "affectedApps": [
    {
      "appId": "app_2DbBs7GWhGvVNJGrDXr5RG0mBWI",
      "appName": "<string>",
      "appSlug": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Admin API key (format: sk_admin_*) for organization-level operations

Path Parameters

​
phoneNumberId
string
required

Unique identifier for a Phone Number. Format: ph_[test_]{ksuid}

Pattern: ^ph_(?:test_)?[a-zA-Z0-9]{27}$
Example:

"ph_2DbBs7GWhGvVNJGrDXr5RG0mBWI"

Response

Phone number deleted successfully

​
success
boolean
required
​
phoneNumberId
string
required

Unique identifier for a Phone Number. Format: ph_[test_]{ksuid}

Pattern: ^ph_(?:test_)?[a-zA-Z0-9]{27}$
Example:

"ph_2DbBs7GWhGvVNJGrDXr5RG0mBWI"

​
affectedApps
object[]
required