> For the complete documentation index, see [llms.txt](https://docs.thebrief.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thebrief.ai/public-api/rest-api/brand-kits/brand-kit-assets/brand-kit-asset-folders.md).

# Brand kit asset folders

### List brand kit asset folders

This endpoint makes an HTTP GET request to retrieve the asset folders of a brand kit.

#### Request

**Method:** GET\
**Endpoint:** `https://api.thebrief.ai/v1/brandkits/assets/folders`\
**Query parameters:**

* `brandkitId` (integer, **required**): The id of the brand kit.
* `parentId` (integer, optional): If provided, returns only folders nested under this parent. Omit to list root-level folders.

{% code overflow="wrap" %}

```
curl --location 'https://api.thebrief.ai/v1/brandkits/assets/folders?brandkitId=123456' \
--header 'Authorization: Bearer eyJ...'
```

{% endcode %}

#### Response

The response will be in JSON format with the following schema:

{% code overflow="wrap" %}

```json
{
    "response": [
        {
            "id": 100,
            "name": "Product photos",
            "parentId": null
        },
        {
            "id": 101,
            "name": "Lifestyle shots",
            "parentId": 100
        }
    ]
}
```

{% endcode %}

***

### Create a brand kit asset folder

This endpoint makes an HTTP POST request to create a new asset folder in a brand kit.

#### Request

**Method:** POST\
**Endpoint:** `https://api.thebrief.ai/v1/brandkits/assets/folders`\
**Body:**

* `brandkitId` (integer, **required**): The id of the brand kit.
* `name` (string, **required**): The folder display name.
* `parentId` (integer, optional): The parent folder id. Omit to create at the root level.

{% code overflow="wrap" %}

```
curl --location 'https://api.thebrief.ai/v1/brandkits/assets/folders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ...' \
--data '{
    "brandkitId": 123456,
    "name": "Product photos"
}'
```

{% endcode %}

#### Response

The response will be in JSON format with the following schema:

{% code overflow="wrap" %}

```json
{
    "response": {
        "id": 100,
        "name": "Product photos",
        "parentId": null
    }
}
```

{% endcode %}

***

### Rename a brand kit asset folder

This endpoint makes an HTTP PUT request to rename an asset folder in a brand kit.

#### Request

**Method:** PUT\
**Endpoint:** `https://api.thebrief.ai/v1/brandkits/assets/folders`\
**Body:**

* `brandkitId` (integer, **required**): The id of the brand kit.
* `folderId` (integer, **required**): The id of the folder to rename.
* `name` (string, **required**): The new folder name.

{% code overflow="wrap" %}

```
curl --location --request PUT 'https://api.thebrief.ai/v1/brandkits/assets/folders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ...' \
--data '{
    "brandkitId": 123456,
    "folderId": 100,
    "name": "Hero images"
}'
```

{% endcode %}

#### Response

The response will be in JSON format with the following schema:

{% code overflow="wrap" %}

```json
{
    "response": {
        "id": 100,
        "name": "Hero images",
        "parentId": null
    }
}
```

{% endcode %}

***

### Delete a brand kit asset folder

This endpoint makes an HTTP DELETE request to delete an asset folder from a brand kit.

#### Request

**Method:** DELETE\
**Endpoint:** `https://api.thebrief.ai/v1/brandkits/assets/folders`\
**Body:**

* `brandkitId` (integer, **required**): The id of the brand kit.
* `folderId` (integer, **required**): The id of the folder to delete.

{% code overflow="wrap" %}

```
curl --location --request DELETE 'https://api.thebrief.ai/v1/brandkits/assets/folders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ...' \
--data '{
    "brandkitId": 123456,
    "folderId": 100
}'
```

{% endcode %}

#### Response

The response will be in JSON format with the following schema:

{% code overflow="wrap" %}

```json
{
    "response": {
        "success": true
    }
}
```

{% endcode %}

***