Skip to main content
GET
List the organizations a token can act in

Authorizations

Authorization
string
header
required

Personal access token of a ROOTKey user, sent as Authorization: Bearer rk_pat_.... A token acts as the user who created it, in the organization named by the X-RootKey-Organization header, and never with more access than that user has in the ROOTKey app: the organization's agent policy, the user's own role and teams, and the token's scopes (rootkey.read, rootkey.write, rootkey.delete) all apply. A missing, malformed, unknown, revoked or expired token gets the same 401. Send either an x-api-key or a bearer token, never both: a request with both gets conflicting_credentials. See Authentication.

Headers

x-test-mode
enum<string>
default:false

Whether a personal access token works on live data (false, the default) or on test data (true). Only this header decides, never a query string or a body field. An API key is itself a test or a live key and works on that data.

Available options:
true,
false

Query Parameters

cursor
string

The pagination.nextCursor of the previous page. It is opaque; a cursor that is not valid gets invalid_cursor, never a restart from the first page.

limit
integer
default:20
Required range: 1 <= x <= 100
order
enum<string>
default:desc

By creation time.

Available options:
asc,
desc

Response

A page of organizations

data
object[]
pagination
object
metadata
object