Brands
The white-label brand of a verified custom host.
Return the brand of a verified custom host
GET
/v1/brands/by-hostbrands.get-by-hosthost is a hostname such as app.agency.com (no scheme or port), matched case-insensitively. Returns the product name, logo, favicon (Kenso defaults where the brand has none), and the Auth0 organization to log in with. Cacheable for 60 seconds.
Parameters
Name
In
Type
Required
Description
host
In: query
string
optional
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
Response 200
data is a BrandByHostModel.
Field
Type
Description
hostname
string
productName
string
logoUrl
string
faviconUrl
string
auth0OrganizationId
string
Auth0 organization the login on this host uses. Omitted while the workspace has none.
accentColor
string
Accent color,
#RRGGBB uppercase. Omitted when the Kenso default applies.Request
curl -X GET "https://api.ken.so/v1/brands/by-host" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02"
Response 200
{
"success": true,
"data": {
"hostname": "string",
"productName": "string",
"logoUrl": "https://example.com",
"faviconUrl": "https://example.com",
"auth0OrganizationId": "string",
"accentColor": "string"
}
}