---
title: "Add one or more tenants"
method: POST
path: "/tenants"
tags: ["🧩 Multi-tenants"]
---

# Add one or more tenants

`POST /tenants`

Add one or more tenants to existing list. Already defined tenants (same id) are updated

## Request body

- Tenant[]
  - `id` string — A unique identifier for a tenant, matching ^(\p{Alnum}[\p{Alnum}-_]*)$
  - `name` string — A name for humans
  - `description` string — One line description of the tenant, typically used to get a glimpse of tenant goal.
  - `documentation` string — A long form description of the tenant, accepting markdown

## Response `200`

List of actually added/updated tenants

- object
  - `result` 'success' | 'error', required — Result of the request
  - `action` 'updateGroup', required — The id of the action
  - `data` object, required
    - `tenants` Tenant[], required
      - `id` string — A unique identifier for a tenant, matching ^(\p{Alnum}[\p{Alnum}-_]*)$
      - `name` string — A name for humans
      - `description` string — One line description of the tenant, typically used to get a glimpse of tenant goal.
      - `documentation` string — A long form description of the tenant, accepting markdown

---

[API](https://skmtc.net/rudder/apis/rudder-api.md) · [All operations](https://skmtc.net/rudder/apis/rudder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rudder/rudder-api/revisions/eab988254fba/schema)