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
| Name | Type | Description |
|---|---|---|
org | string | The 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"]
}
]
| Field | Type | Description |
|---|---|---|
id | string | tnt_… |
name | string | |
logo | URL | |
mode | closed | public | workspace | domain | Who can join |
workspaces | { provider, domain }[] | Present only when mode is workspace |
email_domains | string[] | Present only when mode is domain |
Errors
| Status | error | When |
|---|---|---|
404 | not_found | The org does not exist, or your token cannot manage it |
Example
curl https://loginwith.loginwith.dev/organizations/acme/tenants \
-H "Authorization: Bearer $TOKEN"