List organization members

GET/v1/organization/members

Authorization

AuthorizationBearer token · headerrequired

Query parameters

limitinteger<int64>

min 1 · max 200

afterstring<uuid>

orderOrderParam

Descending user id when omitted.

Allowed:ascdesc

Responses

200One page by user id, descending unless order=asc.

itemsOrgMemberBody[]required

Show properties

Array of OrgMemberBody

created_atstring<date-time>required

display_namestring | nullrequired

primary_emailstring | nullrequired

roleOrgRoleBodyrequired

What a member may do in the organization. An admin manages members, invitations, and billing; a member does not.

Allowed:adminmember

user_idstring<uuid>required

next_cursorstring<uuid> | nullrequired

`None` on the last page.

400Bad limit, cursor, or order.

errorErrorDetailrequired

What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.

Show properties

codeErrorCoderequired

The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.

Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal

messagestringrequired

401Missing, malformed, or invalid bearer token.

errorErrorDetailrequired

What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.

Show properties

codeErrorCoderequired

The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.

Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal

messagestringrequired

403Caller lacks org.members.read.

errorErrorDetailrequired

What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.

Show properties

codeErrorCoderequired

The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.

Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal

messagestringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

limitqueryafterqueryorderqueryDescending user id when omitted.

Request

curl -X GET "https://api.us.cloud.subako.ai/v1/organization/members" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.us.cloud.subako.ai/v1/organization/members", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.us.cloud.subako.ai/v1/organization/members",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "items": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "display_name": "string",
      "primary_email": "string",
      "role": "admin",
      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
    }
  ],
  "next_cursor": "a7ec8888-a9c3-4732-a281-9a08510f220b"
}

{
  "error": {
    "code": "unauthorized",
    "message": "string"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "string"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "string"
  }
}