White-label branding (Enterprise)
White-label branding lets you replace LeonAI's identity with your own on the public pages your audience sees — link-in-bio pages and shared analytics pages. Set a logo, a brand color, a brand name, and hide the "Powered by LeonAI" footer.
Reading branding is available on any tier (it returns sensible defaults). Writing
branding is an Enterprise feature — a PUT from a lower tier returns 403.
Read your branding
curl https://api.short.leonai.io/api/v1/branding \
-H "X-API-Key: $LEONAI_API_KEY"
Response (200 OK):
{
"success": true,
"data": {
"logoUrl": null,
"brandColor": "#14b8a6",
"brandName": null,
"hidePoweredBy": false
}
}
REST: GET /api/v1/branding. On tiers below Enterprise this returns the defaults shown
above.
Update your branding (Enterprise)
curl -X PUT https://api.short.leonai.io/api/v1/branding \
-H "X-API-Key: $LEONAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"logoUrl": "https://cdn.example.com/logo.svg",
"brandColor": "#ff5722",
"brandName": "Acme Links",
"hidePoweredBy": true
}'
Response (200 OK):
{
"success": true,
"data": {
"logoUrl": "https://cdn.example.com/logo.svg",
"brandColor": "#ff5722",
"brandName": "Acme Links",
"hidePoweredBy": true
}
}
REST: PUT /api/v1/branding. All fields are optional — send only what you want to change.
| Field | Notes |
|---|---|
logoUrl | Absolute http/https URL of your logo |
brandColor | Hex color in #RRGGBB form |
brandName | Text used in place of "LeonAI" on public pages |
hidePoweredBy | true removes the "Powered by LeonAI" footer |
Where branding shows up
Public payloads carry a branding object (or null when none is set), so the pages can
theme themselves and optionally drop the LeonAI footer:
- Link-in-bio —
GET /api/v1/public/bio/:slug - Shareable analytics —
GET /api/v1/public/analytics/:token
Error codes
| Status | When |
|---|---|
400 | brandColor is not #RRGGBB, or logoUrl is not a valid URL |
403 | Writing branding on a tier below Enterprise (feature gated) |
Related
- Link-in-bio — branded public profiles
- Shareable analytics — branded public reports
- API Reference — the full OpenAPI spec and Swagger UI