GET/root/organizations
List organizations
Operation root.organizations.list
Description
Pages every organization, newest first, optionally narrowed to one exact organization id; names are encrypted, so there is no name search. Only root operators may call it, and each request is recorded in the root audit trail.
Authentication
Requires a signed-in session: the client sends its session token as a bearer token in the Authorization header.
Parameters
| Name | In | Type | Details |
|---|---|---|---|
cursor | query | string | optional
|
limit | query | integer | optional
|
search | query | string | optional
|
Responses
200 OK
application/jsonRootOrganizationsResponse
A page of organizations, newest first.
2 fields
nextCursorstringrequirednullableOpaque cursor for the next page, or null at the end.
Other fields are allowed.
Other responses
| Status | Meaning | Body |
|---|---|---|
| 400 | Bad Request |
|
| 401 | Unauthorized |
|
| 403 | Forbidden |
|
| 404 | Not Found |
|
| 500 | Internal Server Error |
|
| 503 | Service Unavailable |
|