Brand Kits

List Brand kits

This endpoint makes an HTTP GET request to retrieve brand kits based on the provided keyword and limit.

Request

  • Method: GET

  • Endpoint: https://api.creatopy.com/v1beta/brandkits

  • Query Parameters:

    • keyword (query parameter) - The keyword to search brand kits.

    • limit (query parameter) - The maximum number of brand kits to retrieve.

curl --location 'https://api.creatopy.com/v1beta/brandkits?keyword=api&limit=10' \
--header 'Authorization: Bearer ey...'

Response

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

  • totalCount (number) - The total count of brand kits matching the search criteria.

  • nodes (array) - An array of brand kit nodes.

  • pageInfo (object) - Information about the pagination, including whether there is a next page and the end cursor.

{
    "response": {
        "totalCount": 0,
        "nodes": [],
        "pageInfo": {
            "hasNextPage": true,
            "endCursor": ""
        }
    }
}

Create Brand kits

This endpoint allows you to create a new brand kit.

Request

  • Method: POST

  • Endpoint: https://api.creatopy.com/v1beta/brandkits/create

  • Body:

    • name (string, required): The name of the brand kit.

Response

The response is a JSON object with the following schema:

{
    "type": "object",
    "properties": {
        "response": {
            "type": "object",
            "properties": {
                "brandKit": {
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "name": {
                            "type": "string"
                        },
                        "teamId": {
                            "type": "integer"
                        },
                        "typography": {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "fontId": {
                                        "type": ["integer", "null"]
                                    },
                                    "fontName": {
                                        "type": "string"
                                    },
                                    "fontSize": {
                                        "type": "integer"
                                    },
                                    "fontWeight": {
                                        "type": "string"
                                    },
                                    "type": {
                                        "type": "string"
                                    }
                                }
                            }
                        },
                        "createdBy": {
                            "type": "integer"
                        }
                    }
                }
            }
        }
    }
}
{
    "response": {
        "brandKit": {
            "id": 1594754,
            "name": "Brand Kit Name",
            "teamId": 1003479,
            "typography": [
                {
                    "fontId": null,
                    "fontName": "Roboto",
                    "fontSize": 46,
                    "fontWeight": "700",
                    "type": "heading"
                },
                {
                    "fontId": null,
                    "fontName": "Roboto",
                    "fontSize": 24,
                    "fontWeight": "500",
                    "type": "subheading"
                },
                {
                    "fontId": null,
                    "fontName": "IBM Plex Sans",
                    "fontSize": 16,
                    "fontWeight": "400",
                    "type": "body"
                }
            ],
            "createdBy": 141
        }
    }
}