Lists the people of the organization's workspaces in the current region, one row per email. The list has two parts. The roster holds permanent direct and group-derived workspace members, visible invitations, and pending assignments of people that a customer's directory pushed (status assigned, or seat_denied after a grant failed for lack of a seat). A workspace owner whom an admin or a customer's directory removed keeps the owner entries, with the status transfer_required. The tail holds the pushed people with no access entry, each with an empty workspace_access and the status no_access. The tail always comes after the roster. One cursor pages the two parts: first rows a page, 100 when not given, at most 100, and after set to page_metadata.end_cursor. last and before answer 400: the cursor goes forward only. A cursor of another sort answers 400. search matches a part of the name or the email, and ignores case. origin applies to the person. workspace_ids, roles and status must all match one entry of the person: workspace_ids=A&roles=admin keeps the admins of A only. has_api_keys keeps people with or without active keys. api_key_state keeps people with a visible key in any requested state. inactive=true keeps billable seat holders with no activity in the last 30 days. The tail has no keys or seats. A filter on api_key_state or inactive=true leaves out the tail. The tail also requires no workspace_ids or roles, and has_api_keys cannot be true. If set, status must include no_access and origin must include directory. The response includes all visible access entries and keys for each matching person. page_metadata.total_count is the kept roster rows plus the kept tail rows of all pages. Pending assignments and the tail exist only for SSO connections that use the directory user model. Each person takes one seat, at their highest permanent billable direct role in the local workspaces. A pending assignment takes no seat. The seat distribution, attention counts, and API key counts cover the full roster before filters and pagination. Requires organization administration permission.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
