Release a number back to the pool

POST

/api/phone-numbers/{id}/release

Fully releases one of the tenant's phone numbers: clears any agent assignment and returns ownership of the number to the shared platform pool.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Path Params

🟢200Success

application/json

Number released and returned to the pool.

Bodyapplication/json

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.snakk.ai/api/phone-numbers//release' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Phone number released and returned to pool"
}

Modified at 2026-07-08 19:01:40