Organization Members, Roles, and Role Assignments
September 1st, 2026
Three read endpoints for an organization's access configuration are now available on V4:
GET /memberslists the members of the organization tied to the API credentials, with each member'sid,user_id,email,first_name,last_name, andstatus(ACTIVE,ARCHIVED, orPENDING). Identity only; it does not return role assignments.GET /roleslists every role defined in the organization with itsname, optionaldescription, anis_system_roleflag distinguishing built-in roles from org-authored ones, and the flat set of permission keys it grants. Each permission is an opaque, colon-delimited string; do not rely on its internal structure.GET /role-assignmentslists which member is assigned which role and the scope of that assignment:ORGANIZATIONfor the whole organization, orSUBSIDIARYfor a single subsidiary. Accepts an optionalmember_idfilter.
Members and roles are referenced by id, so join GET /role-assignments against GET /members and GET /roles to resolve names. All three endpoints are paginated via limit and cursor.
