Provisions (or updates) a tenant. Used by the dashboard gateway to create a…

The provisioned tenant

POST /v1/tenants

cURL

curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/tenants' \
  --header "Authorization: Bearer $EDI_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "created_at": "2026-08-31T14:22:05Z",
  "display_name": "Ada Lovelace",
  "enabled": true,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'

200

{
  "created_at": "2026-08-31T14:22:05Z",
  "display_name": "Ada Lovelace",
  "enabled": true,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Request body

Tenant

created_at · string,null (date-time)

display_name · string · required

enabled · boolean

id · string · required

Stable tenant identifier (slug), e.g. acme-com.

Response

Tenant

created_at · string,null (date-time)

display_name · string · required

enabled · boolean

id · string · required

Stable tenant identifier (slug), e.g. acme-com.

Status codes

Code	Meaning
200	The provisioned tenant
403	Admin credential required
422	Single-tenant deployment (no DATABASE_URL)

Using this contract

Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.

cURL

curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/tenants' \
  --header "Authorization: Bearer $EDI_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "created_at": "2026-08-31T14:22:05Z",
  "display_name": "Ada Lovelace",
  "enabled": true,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'

200

{
  "created_at": "2026-08-31T14:22:05Z",
  "display_name": "Ada Lovelace",
  "enabled": true,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}