Organisation
Get access review
Every member’s roles, teams, individually shared resources, last activity and how they joined.
GET
Returns one row per person in your organisation, active or suspended, for a periodic access review. Agents and service accounts are left out.
Each row lists the member’s roles, the teams they belong to, and
direct_access: how many resources of each kind they hold a grant on individually, such as {"repository": 3, "session": 12}. It counts what they created and what was shared with them by name. Access they have through a team or a role is not counted there; see teams and the roles instead.
last_active_at is the last time the member used Wordsmith as themselves, on any surface: the apps, Slack, Teams, email, an API key or a connected app. Wordsmith records it at most once an hour. It is null for a member who has not used Wordsmith since Wordsmith started recording it. inactive_since is when the inactivity policy counts their inactivity from.
join_method is invite when the member accepted an invite, with who sent it and when. Otherwise it is other: they joined through single sign-on, SCIM, domain auto-join, Slack or Teams.
incomplete_member_ids lists members whose individual grants could not be read. Their direct_access is null, not an empty count. Request the review again.
Inactivity policy
dormancy_policy is your organisation’s inactivity policy. When dormant_after_days is set, Wordsmith suspends each member in scope (all_members, or only members marked is_external) who has had no activity for that many days, once a day, and tells the members who can reactivate them. A member’s inactivity counts from the latest of their last activity, when they joined, when they were last reactivated, when an admin marked them external (for an external-only policy), and when the policy was last turned on or changed (enabled_at).
Authentication
Requires an API key, or an OAuth token withdirectory:admin. The caller must also be an organisation admin, or hold a role with the access review permission. directory:admin is never granted by default.
Response
Returns200 with the review.