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

# Get tenant groups schema

`GET /api/v1/tenants/groups/schema`

Get all tenant groups as a TenantGroupSchema object.

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

RLS: Filtered to current client (ClientRLSDB).

## Response `200`

Successful Response

- TenantGroupSchema — Schema for tenant group configuration files
  - `tenant_groups` TenantGroup[], required — Array of tenant group configurations
    - `description` string, nullable — Description text
    - `kater_id` string, uuid, required — Unique Kater identifier
    - `name` string, required — Name identifier

## 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/groups/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)