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.

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

Response

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

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

---

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.

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

Response

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

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

---

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.

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

Response

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

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

---

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.

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

Response

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

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

---