folderBrand 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.

Response

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


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.

Response

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


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.

Response

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


Last updated