---
title: "Delete folder"
method: DELETE
path: "/folder/{folderId}"
tags: ["Folder"]
---

# Delete folder

`DELETE /folder/{folderId}`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/folder/{folderId}`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

### DELETE /v1/folder/:folderId

This endpoint is used to delete a specific folder identified by the `folderId`. The deletion operation will remove the folder and all its contents from the system.

#### Request Parameters

- `folderId` (path parameter): The unique identifier of the folder that you wish to delete. This parameter is required.


#### Response Structure

Upon successful deletion, the response will return a JSON object with the following structure:

- `status`: A string indicating the status of the operation (e.g., success or failure).

- `message`: A string providing additional information about the result of the deletion operation.


#### Example Response

``` json
{
 "status": "success",
 "message": "Folder deleted successfully."
}

 ```

In case of an error, the response may contain an appropriate error message indicating what went wrong.

## Path parameters

- `folderId` string, required

## Response `200`

OK

- object
  - `status` string
  - `message` string

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)