numbers

Delete Number

Release (delete) a phone number.

This will:

  1. Release the number from its upstream provider when supported
  2. Mark the number as "released" in the database
  3. Keep all messages and conversation history (for audit purposes)

WARNING: This action is irreversible! The number cannot be recovered.

delete/v1/numbers/{number_id}

Request

  • Base URL
    https://api.agentphone.ai
  • URL
    https://api.agentphone.ai/v1/numbers/{number_id}
  • Auth
    HTTP bearer

Path parameters

number_idstring required

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 42 revisions of this API.