Phone Numbers

Unassign DID (15-day cool-off enforced)

Move the DID back to the parent pool.

A 15-day cool-off is enforced: if the DID had a call within the last 15 days, the request is rejected with 409 and a did_cool_off_in_effect error that includes cool_off_until and cool_off_remaining_seconds. Never-used DIDs (last_call_at is NULL) move back immediately.

Admins can bypass the cool-off with ?force=true (see below); the bypass writes a did_assignment_audit row and requires an admin-role account.

delete/api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount

Request

Base URL
https://api.vobiz.ai
Auth
API key in header X-Auth-ID and API key in header X-Auth-Token
TypeScript
https://skmtc.dev/vobiz/apis/vobiz-api/docs/api/v1/account/:auth_id/numbers/:e164/assign-subaccount/delete.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

auth_idstring required

Example:MA_XXXXXX

Your account Auth ID

e164string required

Example:%2B919876543210

The number in E.164, URL-encoded (use %2B instead of +).

Query parameters

forceboolean

Example:true

Admin-only cool-off bypass. Requires an admin-role account (enforced at the gateway) and writes a did_assignment_audit row.

Response

DID moved back to the parent pool

Changes

No recorded changes to this operation across all 1 revision of this API.