---
title: "Delete a sub-account"
method: DELETE
path: "/api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}"
tags: ["Sub-Accounts"]
---

# Delete a sub-account

`DELETE /api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}`

## Request

- Base URL: `https://api.vobiz.ai`
- URL: `https://api.vobiz.ai/api/v1/accounts/{auth_id}/sub-accounts/{sub_auth_id}`
- 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/accounts/:auth_id/sub-accounts/:sub_auth_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Permanently delete a sub-account and revoke its credentials.

## Path parameters

- `auth_id` string, required
- `sub_auth_id` string, required

## Response `200`

Success

- object
  - `message` string, required

## Other responses

- `204`: Sub-account deleted

---

[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)