---
title: "Get tenants schema"
method: GET
path: "/api/v1/tenants/schema"
tags: ["tenants"]
---

# Get tenants schema

`GET /api/v1/tenants/schema`

Get all tenants as a TenantSchema object.

Returns tenants in the YAML-compatible schema format with group references.
Supports content negotiation: JSON by default, YAML with Accept: application/yaml.

RLS: Filtered to current client (ClientRLSDB).

## Response `200`

Successful Response

- TenantSchema — Schema for tenant configuration files
  - `tenants` Tenant[], required — Array of tenant configurations
    - `groups` TenantRefString[], nullable — References to tenant groups this tenant belongs to
    - `kater_id` string, uuid, required — Unique Kater identifier
    - `name` string, nullable — Human-readable display name for the tenant
    - `tenant_key` string, required — Unique key identifier for the tenant (e.g., 'acme_corp')

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2026-02-26** `bef1f3e205dd` — 2 breaking
  - response property `errors` list-of-types was widened by adding types `array` to media type `application/json` of response `400`
  - response property `errors` list-of-types was widened by adding types `array` to media type `application/json` of response `401`
- **2026-02-10** `4255a68f5e27` — 1 info
  - endpoint added
- **2026-02-10** `ebda7b8f581d` — 1 breaking
  - api path removed without deprecation
- **2026-02-08** `91ea1d9f6c07` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kater-ai/apis/kater-api/changes/api/v1/tenants/schema/get.md)

---

[API](https://skmtc.dev/kater-ai/apis/kater-api.md) · [All operations](https://skmtc.dev/kater-ai/apis/kater-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kater-ai/kater-api/revisions/6a140b82e07c/schema)