---
title: "Create a tenant"
method: POST
path: "/tenants"
tags: ["Tenant"]
---

# Create a tenant

`POST /tenants`

## Request body

- Tenant
  - `tenantRole` 'SERVER' | 'BROKER' | 'MINION', required
  - `tenantName` string, required
  - `numberOfInstances` integer
  - `offlineInstances` integer
  - `realtimeInstances` integer

## Response `200`

Success

## Other responses

- `500` — Error creating tenant

---

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