Skip to Content
kosemdocs
ReferenceAPIOrganizations

List organizations

Lists the organizations the caller can see: those they hold resourcemanager.organizations.get on, which every member and guest does.

GET
/v1/organizations

Lists the organizations the caller can see: those they hold resourcemanager.organizations.get on, which every member and guest does.

Authorization

bearer
headerAuthorizationBearer <token>

An access token, or an API key.

Query Parameters

pageSize?integer

Maximum number of organizations to return. Defaults to 50; values above 500 are treated as 500.

Formatint32
Range0 <= value
pageToken?string

Page token from a previous response.

Response Body

OK

application/json
  1. response
nextPageToken*string

Token for the next page; empty on the last page.

organizations*array<>

Organizations, oldest first.

Example Request
curl -X GET 'https://api.kosem.ai/v1/organizations'
Example Response
{
  "nextPageToken": "string",
  "organizations": [
    {
      "createTime": "2019-08-24T14:15:22Z",
      "displayName": "string",
      "name": "string",
      "slug": "string",
      "state": "ACTIVE",
      "updateTime": "2019-08-24T14:15:22Z"
    }
  ]
}