List tenants

Every tenant in the organization.

GET /organizations/{org}/tenants

Tenants are the groups your users sign in to. An org always has at least one. Not paginated.

Authorization

Any member of the org. A non-member gets 404, the same as for an org that does not exist.

Path parameters

NameTypeDescription
orgstringThe organization: its id (org_…) or its slug. It has to be an org your token can manage (see Who can call it)

Response

200 OK with an array of tenants.

[
  {
    "id": "tnt_65f1c2a9e4b0d3f7a1c8e908",
    "name": "Acme France",
    "logo": "https://…",
    "mode": "domain",
    "email_domains": ["acme.fr"]
  }
]
FieldTypeDescription
idstringtnt_…
namestring
logoURL
modeclosed | public | workspace | domainWho can join
workspaces{ provider, domain }[]Present only when mode is workspace
email_domainsstring[]Present only when mode is domain

Errors

StatuserrorWhen
404not_foundThe org does not exist, or your token cannot manage it

Example

curl https://loginwith.loginwith.dev/organizations/acme/tenants \
  -H "Authorization: Bearer $TOKEN"