--- title: "Unassign DID (15-day cool-off enforced)" method: DELETE path: "/api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount" tags: ["Phone Numbers"] --- # Unassign DID (15-day cool-off enforced) `DELETE /api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount` ## Request - Base URL: `https://api.vobiz.ai` - URL: `https://api.vobiz.ai/api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount` - Auth: API key in header `X-Auth-ID` and API key in header `X-Auth-Token` - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. ## Path parameters - `auth_id` string, required - `e164` string, required ## Query parameters - `force` boolean ## Response `200` DID moved back to the parent pool ## Other responses - `204`: DID moved back to the parent pool - `403`: `force=true` requested without an admin-role account - `409`: Cool-off in effect — the DID had a call within the last 15 days --- [API](https://skmtc.dev/vobiz/apis/vobiz-api.md) - [All operations](https://skmtc.dev/vobiz/apis/vobiz-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vobiz/apis/vobiz-api/revisions/863f08cd6737?raw)