---
title: "Tenant"
description: "a tenant: Tenant, a entity of the people family at platform scope"
section: concepts
address: /concepts/tenant
contract: 0476e35e6e275db5
---

# Tenant

a tenant: Tenant, a entity of the people family at platform scope

[figure: Tenant is a entity at platform scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | entity |
| scope | platform |
| key | its id |
| store | postgres |
| family | people |



## Fields


| field | type | required | note |
|---|---|---|---|
| `name` | `text` | yes |  |
| `company` | `id` | yes | the entity of the record it is |
| `plan` | [SubscriptionPlan](/concepts/subscriptionplan) | yes |  |
| `autonomy_ceiling` | `{text:enum:read only \| propose \| act \| full autonomy}` | yes | for each kind of reach |
| `state` | [Readiness](/concepts/readiness) | yes | not ready with its reason when suspended |
| `retired_at` | `time` | no |  |



## Routes that use it
- [`/v1/act/sign_up`](/reference/act/sign_up) returns it