Skip to Content
Workspace and account

White-label brands

The white-label brand of a verified custom host.

Workspace and account1 endpointKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

Headers

The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe 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

GET/v1/brands/by-hostbrands.get-by-host
Permission
None: no API key needed
Rate limit
120 requests a minute per IP address

Try it on developer.ken.so

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: host is missing or is not a hostname.
  • 404 not_found: no verified brand uses this hostname.

Needs no credential.

Parameters

NameInTypeRequiredDescription
hostquerystringoptionalThe hostname to look up, such as app.agency.com.
Request
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.


On this page