Tenants

Get a tenant

Changed on Aug 13, 2026

Get a tenant by ID.

get/v1/tenants/{id}

Request

Base URL: https://api.knock.app
URL: https://api.knock.app/v1/tenants/{id}
Auth: HTTP bearer

Path parameters

idstring required

The unique identifier for the tenant.

Query parameters

resolve_full_preference_settingsboolean

When true, merges environment-level default preferences into the tenant's settings.preference_set field before returning the response. Defaults to false.

Response

__typenamestring required

The typename of the schema.

idstring required

The unique identifier for the tenant.

namestring nullable

An optional name for the tenant.

Example response

{
  "__typename": "Tenant",
  "id": "tenant_jp123",
  "name": "Jurassic Park",
  "settings": {
    "branding": {
      "dark_icon_url": "https://example.com/trex_silhouette_icon_dark.png",
      "dark_logo_url": "https://example.com/amber_fossil_logo_dark.png",
      "dark_primary_color": "#FFFFFF",
      "dark_primary_color_contrast": "#000000",
      "icon_url": "https://example.com/trex_silhouette_icon.png",
      "logo_url": "https://example.com/amber_fossil_logo.png",
      "primary_color": "#DF1A22",
      "primary_color_contrast": "#FFDE00"
    },
    "preference_set": {
      "categories": {
        "safety": {
          "channel_types": {
            "email": true,
            "push": true
          }
        }
      },
      "channel_types": {
        "email": true,
        "in_app_feed": true,
        "push": true
      },
      "id": "default",
      "workflows": {
        "park_alert": {
          "channel_types": {
            "email": true,
            "push": true
          }
        }
      }
    }
  }
}

Changes

Aug 13, 2026fcba175ebc76 Revision changes
- breaking
  the /// response's property type changed from boolean to no type for status
- info
  added subschema #1 subschema #3 to the /// response property anyOf list for the response status
Jul 14, 2026de4604427056 Revision changes
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////////// response property for the response status
- warning
  added the new not_contains_all enum value to the ///////// response property for the response status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history (6 revisions)