Brand Kits

A brand kit stores your logo, color palette, fonts, and fallback values. Reference it by ID in every render request.

Creating a brand kit

Create a brand kit with your visual identity assets:

POST /v1/brand-kits
curl -X POST https://api.imageclaw.dev/v1/brand-kits \
  -H "Authorization: Bearer $IMGCLAW_API_KEY" \
  -d '{
        "name": "Acme Corp",
        "logo_url": "https://acme.com/logo.svg",
        "colors": { "primary": "#2F5BFF", "bg": "#FFFFFF" },
        "font_family": "Inter"
      }'

Using a brand kit

Pass the brand kit ID when rendering. Any fields not explicitly provided will fall back to the brand kit defaults.

POST /v1/images
curl -X POST https://api.imageclaw.dev/v1/images \
  -H "Authorization: Bearer $IMGCLAW_API_KEY" \
  -d '{
        "template": "blog-gradient-v1",
        "title": "Welcome to Acme",
        "brandKitId": "brand_9f2c",
        "size": "1200x630"
      }'

What gets resolved

When a brand kit is referenced, the following values are automatically resolved:

  • Logo — Placed in the designated logo slot
  • Colors — Applied to backgrounds, text, and accents
  • Font family — Used for all text in the render
  • Fallbacks — Default values for optional template fields