> For the complete documentation index, see [llms.txt](https://docs.ospree.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ospree.io/developers/accounts-directory/remove-account.md).

# Remove account

<mark style="color:red;">`DELETE`</mark> `/api/v2/directory/accounts/{reference_id}`

This endpoint is used to remove a specific account identified by `reference_id` from the directory.

Path Parameters

<table><thead><tr><th width="161">Name</th><th width="111">Type</th><th width="341">Description</th><th>Required</th></tr></thead><tbody><tr><td><code>reference_id</code></td><td>string</td><td>Unique identifier for the account, previously external_id. Example: <mark style="color:orange;"><code>johndoe</code></mark></td><td>True</td></tr></tbody></table>

Response

{% tabs %}
{% tab title="200" %}

```json
{
  "status": "success",
  "data": "Successfully deleted account with reference id of: johndoe"
}
```

{% endtab %}
{% endtabs %}