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

tenant per WorkOS organization. Requires Postgres.

POST /v1/tenants

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/tenants' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --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"
}

tenant per WorkOS organization. Requires Postgres.

Request body

Tenant

created_at · string (date-time)

display_name · string · required

enabled · boolean

id · string · required

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

Response

Tenant

created_at · string (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)

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/tenants' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --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"
}