Phone Numbers

Release a rented phone number

Changed on

Releases a phone number previously rented via POST /product/rent-number. The number goes back into provider inventory and recurring charges stop.

Returns 400 if the number is still assigned to an agent — detach it from the agent first (PATCH /agent/{agentId} with productId: null).

post/product/release-number

Request

  • Base URL
    https://api.smallest.ai/atoms/v1
  • URL
    https://api.smallest.ai/atoms/v1/product/release-number
  • Auth
    HTTP bearer

Request body

productIdstring required

24-char hex MongoDB ObjectId of the phone-number product to release (the _id value returned by GET /product/phone-numbers).

Example request

{
  "productId": "6969109c84c74bed175f02a7"
}

Response

Number released

statusboolean

Example response

{
  "status": true,
  "data": {
    "success": true
  }
}

Changes