Brand & assets

Manage your saved brand profile, generate deterministic brand-kit assets, and create logo marks.

A brandkit/render output — generated from a saved brand profile, no prompt.

POST/api/v1/brandFree

Updates your global brand kit (logo, colors, name). Changes apply automatically to all subsequent API generations unless a call passes its own per-request brand override.

Parameters

Field	Type	Description & options
name	String	Your company or brand name.
handle	String	Social handle shown alongside the name, e.g. @acme.
logo	String	Data URI with base64-encoded PNG/SVG, or an https URL — e.g. data:image/png;base64,...
colors	Object	Brand hex colors — e.g. { primary: '#FF0000', secondary: '#00FF00' }
tagline	String	Optional brand tagline shown in generated assets.

Code sample

curl -X POST https://api.capci.app/api/v1/brand \
  -H "x-api-key: capci_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "tagline": "Build faster, together",
    "colors": { "primary": "#6366f1", "secondary": "#22d3ee" }
  }'

GET/api/v1/brandkitFree

Lists available brand-kit assets (LinkedIn/X/YouTube covers, logo cards, meeting backgrounds) with their ids and dimensions.

curl https://api.capci.app/api/v1/brandkit -H "x-api-key: capci_your_api_key"

POST/api/v1/brandkit/renderFree

Generates a brand-kit asset from your saved brand profile — deterministic, no additional AI call, no charge.

Field	Type	Description & options
id	Required	Asset id from GET /api/v1/brandkit.
theme	String	Color mode, where the asset supports it. `light (default)dark`
tagline	String	Overrides your saved brand tagline for this generation.
pills	Array	Up to 10 short chip labels, where the asset supports them.

curl -X POST https://api.capci.app/api/v1/brandkit/render \
  -H "x-api-key: capci_your_api_key" -H "Content-Type: application/json" \
  -d '{ "id": "linkedin-cover", "theme": "dark" }'

POST/api/v1/logoPay-per-use

Generates a logo mark from your description, in your brand colors. The only metered action on the whole API — first logo free, then credits per logo, independent of plan tier and separate from the unlimited generation endpoints above. See Pricing for credit costs.

Field	Type	Description & options
prompt	Required	What the mark should depict, e.g. "a minimalist mountain peak". No text/letters are ever included in the mark. Up to 2000 characters.

curl -X POST https://api.capci.app/api/v1/logo \
  -H "x-api-key: capci_your_api_key" -H "Content-Type: application/json" \
  -d '{ "prompt": "a minimalist mountain peak" }'
# → { "image": "data:image/png;base64,…", "freeLeft": 0, "credits": 175 }