> 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-logos/brand-kit-logo-folders.md).

# Brand kit logo folders

### List brand kit logo folders

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

#### Request

**Method:** GET\
**Endpoint:** `https://api.thebrief.ai/v1/brandkits/logos/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/logos/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": 10,
            "name": "Primary logos",
            "parentId": null
        },
        {
            "id": 11,
            "name": "Dark variants",
            "parentId": 10
        }
    ]
}
```

{% endcode %}

***

### Create a brand kit logo folder

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

#### Request

**Method:** POST\
**Endpoint:** `https://api.thebrief.ai/v1/brandkits/logos/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/logos/folders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ...' \
--data '{
    "brandkitId": 123456,
    "name": "Seasonal",
    "parentId": 10
}'
```

{% endcode %}

#### Response

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

{% code overflow="wrap" %}

```json
{
    "response": {
        "id": 42,
        "name": "Seasonal",
        "parentId": 10
    }
}
```

{% endcode %}

***

### Rename a brand kit logo folder

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

#### Request

**Method:** PUT\
**Endpoint:** `https://api.thebrief.ai/v1/brandkits/logos/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/logos/folders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ...' \
--data '{
    "brandkitId": 123456,
    "folderId": 42,
    "name": "Holiday logos"
}'
```

{% endcode %}

#### Response

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

{% code overflow="wrap" %}

```json
{
    "response": {
        "id": 42,
        "name": "Holiday logos",
        "parentId": 10
    }
}

```

{% endcode %}

***

### Delete a brand kit logo folder

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

#### Request

**Method:** DELETE\
**Endpoint:** `https://api.thebrief.ai/v1/brandkits/logos/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/logos/folders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ...' \
--data '{
    "brandkitId": 123456,
    "folderId": 42
}'
```

{% endcode %}

#### Response

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

{% code overflow="wrap" %}

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

{% endcode %}

***

<br>