White-label brands
The white-label brand of a verified custom host.
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | The API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy. |
Get a brand by hostname
/v1/brands/by-hostbrands.get-by-host- Permission
- None: no API key needed
- Rate limit
- 120 requests a minute per IP address
Returns the brand of a verified custom hostname: its product name, logo, favicon, accent color and the Auth0 organization to sign in with. Where the brand sets no name, logo or favicon, the response carries the Kenso defaults. Kenso marks the response cacheable for 60 seconds.
Send host as a bare hostname such as app.agency.com, with no scheme, port or path. Case and a trailing dot do not matter.
Errors:
400 validation_failed:hostis missing or is not a hostname.404 not_found: no verified brand uses this hostname.
Needs no credential.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
host | query | string | optional | The hostname to look up, such as app.agency.com. |
curl -X GET "https://api.ken.so/v1/brands/by-host" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02"Response 200
data is a BrandByHost.
Show the 6 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
More in Workspace and account:Your accountWorkspacesSandboxesMembersPermission templatesAccess requestsCreditsCredit estimatesCredit ledgerCredit rate cardCredit savingsCredit savings rowsCredit spendCLI loginBug reportsAll resources