Skip to main content
GET
List organizations the caller can see (or one by name)

Authorizations

Authorization
string
header
required

Authorization code flow with PKCE-S256. RFC 8628 device flow is also supported.

Headers

If-None-Match
string

Query Parameters

pageSize
integer<int32>

Maximum entries to return; server may cap further.

Required range: 0 <= x <= 500
pageToken
string

Opaque cursor from a previous response's nextPageToken.

name
string
deprecated

Deprecated: exact org name among the caller's own orgs, case-insensitive. List orgs and match client-side instead.

commitToken
string

Optional: opaque commit token from an org create or delete, to read at a snapshot that contains that write. Applies to both the name lookup and the page.

Pattern: ^$|^[A-Za-z0-9_-]{20,512}$

Response

OK

$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"/api/v1/schemas/ListOrgsOutputBody.json"

nextPageToken
string

Pass back to fetch the next page; empty when no more entries.

org
object
orgs
object[]