Update Brand Kit
update_brand_kitDestructive
Update existing brand kit with brand DNA parameters. Only company_url is required; all others are optional.
UPDATABLE FIELDS (grouped by section):
TOP-LEVEL:
- long_description: Company marketing description
- logo_url / logo_urls: Direct URL(s) to logo images (permanent override; super-user only)
- clear_logos: true removes the permanent logo override (super-user only)
- search_keywords: List of SEO/search keywords
- colors: Legacy flat color list [{hex, type, name?}]
- fonts: Legacy flat font list [{name, type}]
- website_background: Hex color of the brand website's background, used by generate_brand_creative as the default ad background
COLOR PALETTES (each entry: {hex, name, usage}):
- primary_colors, accent_colors, extended_palette, semantic_colors
TYPOGRAPHY (string values):
- primary_font, primary_font_usage, secondary_font, secondary_font_usage
- headline_font, headline_weight, headline_size, headline_case, headline_linespace, headline_letterspace
- eyebrow_font, eyebrow_weight, eyebrow_case, eyebrow_linespace, eyebrow_letterspace
- subtitle_font, subtitle_weight, subtitle_linespace, subtitle_letterspace
- body_font, body_weight, body_size, body_linespace, body_letterspace
- cta_font, cta_weight, cta_size, cta_linespace, cta_letterspace
LOGO USAGE:
- logo_on_dark, logo_on_light, logo_clear_space: string rules
- logo_misuse: list of misuse rules
CTA SYSTEM:
- button_shape, button_background, button_text_color, button_text_weight, button_text_case, button_padding
- standard_ctas: list of CTA labels
- cta_placement: placement guidance
SIGNATURE ELEMENTS:
- tagline, tagline_placement: strings
- tagline_variants, visual_motifs, promotional_elements: lists
MESSAGING:
- tone: string
- value_propositions, headline_formulas, proof_points: lists
- product_names: dict (e.g. {platform: "X", vlm: "Y"})
CONTENT HIERARCHY:
- content_hierarchy_order: list, content_hierarchy_spacing: string, content_hierarchy_text_max_width: string
PHOTOGRAPHY:
- photography_style, photography_treatment, photography_avoid: strings
- photography_subjects: list
RULES:
- dos: list of "do" rules
- donts: list of "don't" rules
LAYOUT & CHANNELS:
- primary_layouts: list of layout dicts
- channel_linkedin, channel_facebook, channel_display: channel config dicts
EXAMPLE: {"company_url": "ambient.ai", "tagline": "See what matters.", "headline_font": "Chakra Petch", "primary_colors": [{"hex": "#FFFFFF", "name": "White", "usage": "Primary background"}]}Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dos | No | Brand 'do' rules. | |
| tone | No | Brand tone description. | |
| donts | No | Brand 'don't' rules. | |
| fonts | No | Legacy flat font list. Each: {name, type}. | |
| colors | No | Legacy flat color list. Each: {hex (with #), type, name?}. | |
| tagline | No | Primary brand tagline. | |
| cta_font | No | CTA/button font family. | |
| cta_size | No | CTA/button font size. | |
| logo_url | No | Direct URL to a single company logo image (back-compat; prefer logo_urls). Setting a permanent brand logo requires elevated Metadata permissions. | |
| body_font | No | Body text font family. | |
| body_size | No | Body text font size. | |
| logo_urls | No | One or more direct URLs to logo images to set as the brand's permanent logo(s). Each uploaded logo is automatically expanded into clean, persisted variants (transparent, high-res, and both a light and dark version when the mark is a single color) so generated creatives have multiple usable options. Setting a permanent brand logo requires elevated Metadata permissions. | |
| cta_weight | No | CTA/button font weight. | |
| body_weight | No | Body text font weight. | |
| clear_logos | No | Remove the brand kit's permanent logo override entirely (no logo_url needed), so creatives fall back to the cached Brandfetch logo variants for the domain. Use when a manually set logo turned out wrong or low quality. Same elevated Metadata permissions as setting one. | |
| company_url | Yes | Company website URL or domain (e.g. 'ambient.ai'). | |
| logo_misuse | No | List of logo misuse rules. | |
| button_shape | No | Button shape description. | |
| eyebrow_case | No | Eyebrow text case rule. | |
| eyebrow_font | No | Eyebrow font family. | |
| logo_on_dark | No | Logo color rule on dark backgrounds. | |
| primary_font | No | Primary font family name. | |
| proof_points | No | Evidence/social proof items. | |
| accent_colors | No | Accent color palette. | |
| cta_linespace | No | CTA/button line spacing. | |
| cta_placement | No | CTA placement guidance. | |
| headline_case | No | Headline text case rule. | |
| headline_font | No | Headline font family. | |
| headline_size | No | Headline font size range. | |
| logo_on_light | No | Logo color rule on light backgrounds. | |
| product_names | No | Product name mapping (e.g. {platform: 'X', vlm: 'Y'}). | |
| standard_ctas | No | Standard CTA labels. | |
| subtitle_font | No | Subtitle font family. | |
| visual_motifs | No | Brand visual motifs. | |
| body_linespace | No | Body text line spacing. | |
| button_padding | No | Button padding. | |
| eyebrow_weight | No | Eyebrow font weight. | |
| primary_colors | No | Primary color palette. | |
| secondary_font | No | Secondary/display font family name. | |
| channel_display | No | Display ads channel config. | |
| cta_letterspace | No | CTA/button letter spacing. | |
| headline_weight | No | Headline font weight. | |
| primary_layouts | No | Layout system definitions. | |
| search_keywords | No | SEO/search keywords for the brand. | |
| semantic_colors | No | Semantic/status colors. | |
| subtitle_weight | No | Subtitle font weight. | |
| body_letterspace | No | Body text letter spacing. | |
| button_text_case | No | Button text case. | |
| channel_facebook | No | Facebook channel config. | |
| channel_linkedin | No | LinkedIn channel config. | |
| extended_palette | No | Extended grayscale palette. | |
| logo_clear_space | No | Logo clear space rule. | |
| long_description | No | Company description for marketing use. | |
| remove_old_logos | No | When true (default), replace the brand's existing logos with the provided ones; when false, append to them. | |
| tagline_variants | No | Alternative taglines. | |
| button_background | No | Button background style. | |
| button_text_color | No | Button text color rule. | |
| eyebrow_linespace | No | Eyebrow line spacing. | |
| headline_formulas | No | Headline writing patterns. | |
| photography_avoid | No | Photography anti-patterns. | |
| photography_style | No | Photography style description. | |
| tagline_placement | No | Tagline placement guidance. | |
| button_text_weight | No | Button text weight. | |
| headline_linespace | No | Headline line spacing. | |
| primary_font_usage | No | Primary font usage description. | |
| subtitle_linespace | No | Subtitle line spacing. | |
| value_propositions | No | Core value propositions. | |
| website_background | No | 6-digit hex color (e.g. '#FFFFFF') of the brand website's background. generate_brand_creative uses it as the default dominant background for ads (use_website_background). Set it when the user wants ads to match their site's background or the auto-detected value is wrong. | |
| eyebrow_letterspace | No | Eyebrow letter spacing. | |
| headline_letterspace | No | Headline letter spacing. | |
| photography_subjects | No | Recommended photo subjects. | |
| promotional_elements | No | Promotional proof points. | |
| secondary_font_usage | No | Secondary font usage description. | |
| subtitle_letterspace | No | Subtitle letter spacing. | |
| photography_treatment | No | Photo treatment rules. | |
| content_hierarchy_order | No | Content element ordering. | |
| content_hierarchy_spacing | No | Section spacing guidance. | |
| content_hierarchy_text_max_width | No | Max text block width. |