Skip to main content
DELETE
/
api
/
v1
/
phone-numbers
/
release-requests
/
{release_request_id}
curl -X DELETE "https://app.talkover.ai/api/v1/phone-numbers/release-requests/request-uuid-1" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "message": "Release request cancelled"
}

​
Cancel Release Request

Cancel a pending phone number release request before it is approved or rejected. Once cancelled, the phone number remains in your environment.

​
Endpoint

DELETE /api/v1/phone-numbers/release-requests/{release_request_id}

​
Path parameters

​
release_request_id
string
required
UUID of the release request to cancel.

​
Request headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

​
Examples

curl -X DELETE "https://app.talkover.ai/api/v1/phone-numbers/release-requests/request-uuid-1" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Response

{
  "success": true,
  "message": "Release request cancelled"
}

​
Error responses

​
404 — Not Found

{
  "success": false,
  "message": "Release request not found"
}

​
409 — Already Resolved

{
  "success": false,
  "message": "Release request already resolved and cannot be cancelled",
  "code": "RELEASE_ALREADY_RESOLVED"
}

​
Notes

  • Only requests in pending status can be cancelled.
  • Cancelling a request does not delete it — its status is updated to cancelled and remains in List Release Requests.