Branding

All requests use a single endpoint: POST /functions/v1/api with resource: "branding".

Access control

All branding actions require authentication. The user must belong to a team. Branding is stored at the team level.

Action	Any user	Team member	Team owner	Admin
`get` / `all`	No	Yes	Yes	Yes
`update`	No	No	Yes	Yes
`clear`	No	No	Yes	Yes
`generate-logo`	No	Yes	Yes	Yes

Get branding

Retrieves the team’s branding configuration.

string

required

Must be "branding"

string

required

Must be "get" or "all"

const { team, branding } = await ApiService.invoke({
  resource: "branding",
  action: "get",
});

curl https://api.helpgenie.ai/v1/branding \
  -H "Authorization: Bearer hg_live_..."

object

Team object with id, name, branding

object | null

The branding object, or null if no branding is set. Contains primaryColor, secondaryColor, logoUrl, gradientEnabled, gradientAngle, qrCodeStyle, embedStyle, extractedPalette, etc.

Update branding

Updates the team’s branding configuration.

string

required

Must be "branding"

string

required

Must be "update"

object

required

The branding object to set. Replaces the entire branding configuration.

string

Optional team name update (applied alongside branding).

const { team, branding } = await ApiService.invoke({
  resource: "branding",
  action: "update",
  data: {
    branding: {
      primaryColor: "#1B5E8C",
      secondaryColor: "#4E9CFF",
      logoUrl: "https://...",
      gradientEnabled: true,
      gradientAngle: 135,
    },
  },
});

curl -X POST https://api.helpgenie.ai/v1/branding \
  -H "Authorization: Bearer hg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "action": "update",
    "branding": {
      "primaryColor": "#1B5E8C",
      "secondaryColor": "#4E9CFF",
      "logoUrl": "https://...",
      "gradientEnabled": true
    }
  }'

Clear branding

Resets the team’s branding to null (removes all custom branding).

string

required

Must be "branding"

string

required

Must be "clear"

const { team } = await ApiService.invoke({
  resource: "branding",
  action: "clear",
});

curl -X POST https://api.helpgenie.ai/v1/branding \
  -H "Authorization: Bearer hg_live_..." \
  -H "Content-Type: application/json" \
  -d '{"action": "clear"}'

Generate logo

Generate a professional AI logo icon. Returns a transparent PNG uploaded to storage. The logo is an icon/symbol only (no text). Generation takes 15-60 seconds.

string

required

Must be "branding"

string

required

Must be "generate-logo"

string

required

Brand or business name. Used as a thematic hint to inspire the icon design (not rendered as text in the logo).

string

Short business description for prompt context. Example: "A residential plumbing business in Austin, TX"

string

Style preset. One of: modern (default), classic, bold, friendly, tech, luxury.

string

Industry context for relevant iconography. One of: automotive, marine, appliances, office-equipment, home-builders, travel-hospitality, manufacturing, industrial, trades, plumbing, electrical, hvac, landscaping, real-estate, healthcare, fitness, restaurant, retail, technology, education, finance, legal.

const { image_url } = await ApiService.invoke({
  resource: "branding",
  action: "generate-logo",
  data: {
    name: "Plumbing Pros",
    description: "Residential plumbing in Austin, TX",
    industry: "plumbing",
    style: "modern",
  },
});

// Then apply the logo to branding:
await ApiService.invoke({
  resource: "branding",
  action: "update",
  data: {
    branding: { ...existingBranding, logoUrl: image_url },
  },
});

curl -X POST https://api.helpgenie.ai/v1/branding \
  -H "Authorization: Bearer hg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "action": "generate-logo",
    "name": "Plumbing Pros",
    "description": "Residential plumbing in Austin, TX",
    "industry": "plumbing",
    "style": "modern"
  }'

string

Public URL of the generated logo PNG (transparent background). Can be used directly as the logoUrl in a branding update.

string

Supabase Storage path: generated-logos/{filename}.png

string

Replicate prediction ID for debugging/tracking.

The generated logo is a transparent PNG icon/symbol with no text. To apply it to your branding, take the returned image_url and pass it as logoUrl in a subsequent update call.

Overview

Public (unauthenticated)

Agents

Knowledge

CRM

Marketplace

Platform

Telephony

Worker genies

Quality & Compliance

Access Control

Intelligence

Education

Voice

Integrations

Expanded Platform

Access control

Get branding

Update branding

Clear branding

Generate logo

​Access control

​Get branding

​Update branding

​Clear branding

​Generate logo

Access control

Get branding

Update branding

Clear branding

Generate logo