> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE /folders/:folderId

> Delete a folder and all its items.

## Endpoint

```
DELETE /v1/folders/{folderId}
```

## Request

```bash theme={null}
curl -X DELETE "http://client-omni-api.argosidentity.com/v1/folders/{folderId}" \
  -H "x-api-key: your-api-key-here"
```

## Response (204 No Content)

No response body.

<Warning>
  The **default** folder cannot be deleted. Only user-created folders can be removed. Deleting a folder permanently removes all items within it.
</Warning>

### Error Codes

| Status | Code                           | Description                      |
| ------ | ------------------------------ | -------------------------------- |
| 400    | `CANNOT_DELETE_DEFAULT_FOLDER` | Default folder cannot be deleted |
| 404    | `FOLDER_NOT_FOUND`             | Folder not found                 |