---
title: "Get AI helper branding"
method: GET
path: "/api/v1/ai/branding"
tags: ["AI"]
---

# Get AI helper branding

`GET /api/v1/ai/branding`

Returns the organization's AI helper branding — display name, optional custom logo URL, and copy used on AI helper landing surfaces (headline, body, prompt placeholder). Falls back to Omni's defaults when the organization hasn't configured custom branding, so the response is always populated. Used by client apps (iOS, embeds) to render the AI helper with the org's chosen identity.

## Response `200`

AI branding retrieved successfully.

- AiBrandingResponse
  - `body` string, required — Body / description copy shown beneath the headline on AI helper landing surfaces.
  - `headline` string, required — Short headline shown on AI helper landing surfaces.
  - `logoUrl` string, uri, nullable, required — Absolute URL to a custom AI helper logo. `null` when the org has not configured a custom logo — clients should render their default avatar (e.g. Blobby).
  - `name` string, required — Display name for the AI helper. Defaults to `Omni Agent` when no custom branding is set.
  - `placeholder` string, required — Placeholder text for the AI helper's prompt input.

## Other responses

- `401` — Missing or invalid API key.
- `403` — AI access is required to view AI helper branding (no model in the org grants USE_AI to the caller).

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/de7cac8b5983/schema)