# Tenants Object

> Source: https://truto.one/docs/api-reference/admin/tenants/

Schema for the `Tenants` resource in **Admin API**.

## Properties

- **`id`** _(string)_
  The tenant identifier — caller-chosen, URL-path-safe, and immutable once created. Composite primary key with `environment_id`, so the same value can exist independently in `development`, `staging`, and `production`. Must match `^[A-Za-z0-9._:@+-]{1,255}$`.
- **`environment_id`** _(string)_
  The environment this tenant belongs to.
- **`name`** _(string)_
  Display name shown in the dashboard. Defaults to the tenant `id` on create if not supplied; can be edited later via `PATCH /tenant/{id}`.
- **`metadata`** _(object)_
  Free-form JSON object stored verbatim. Truto does not interpret this field — use it for tier, region, billing plan, or any other customer attribute your app cares about.
- **`created_at`** _(string)_
  The date and time when the tenant was created.
- **`updated_at`** _(string)_
  The date and time when the tenant was last updated.

## Methods

- [GET /tenant](/docs/api-reference/admin/tenants/list) — List tenants
- [POST /tenant](/docs/api-reference/admin/tenants/create) — Create tenant
- [POST /tenant/bulk](/docs/api-reference/admin/tenants/create-bulk) — Bulk create tenants
- [GET /tenant/{id}](/docs/api-reference/admin/tenants/get) — Get tenant
- [PATCH /tenant/{id}](/docs/api-reference/admin/tenants/update) — Update tenant
- [DELETE /tenant/{id}](/docs/api-reference/admin/tenants/delete) — Delete tenant