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.

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

Response

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

{
    "response": [
        {
            "id": 10,
            "name": "Primary logos",
            "parentId": null
        },
        {
            "id": 11,
            "name": "Dark variants",
            "parentId": 10
        }
    ]
}

---

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.

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
}'

Response

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

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

---

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.

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"
}'

Response

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

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

---

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.

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
}'

Response

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

{
    "response": {
        "success": true
    }
}

---