Help Center

Understanding Group Management and Actionstep's Public API


Overview

By creating user groups, firm admins can organize staff into meaningful teams and manage membership in one place. Specifically, admins can create, edit, and delete named groups, add or remove staff as their responsibilities change, and maintain a detailed history of each user’s group membership over time. (See Creating and Managing User Groups (Admin) to learn more.) 

If you are an Actionstep API user, please note the following:

Groups can be queried through Actionstep’s API. Any system that integrates with Actionstep — whether that's a reporting tool, a provisioning system, or a custom integration your firm has built — can retrieve a firm's groups and see who belongs to each one. This means group structures set up inside Actionstep can be reflected accurately outside it, too, without someone having to re-enter or reconcile that information by hand.

Restricted matters clearly show their access settings through the API. Two related options make this possible: a simple yes/no flag showing whether a matter is restricted, and a detailed breakdown of exactly which users and groups have been granted access to it. Together, these mean external do not need to piece together restricted-matter access from multiple places — it's available directly, at a glance.

Notes:
• Ensure the account trying to access the groups and group members information has admin access
• Ensure the account trying to access restricted matter list information of a matter has access to the restricted matter

 


Groups and Restricted Matters — API Options

Endpoint Change What it means Example
GET /usersgroups JSON API endpoint returning a firm's groups — name, member count, description, last-modified date (modifiedTimeStamp), and the ID of the user who last modified the group (modifiedBy). Filterable by ID, modified date, and modifying user, and pageable. Admin access only. Lets integrations and reporting tools pull a firm's full group list — and see not just when a group last changed, but who changed it. Groups modified on a given date:
GET /usersgroups?modifiedTimeStamp=2026-08-01

Groups modified on or after a given date:
GET /usersgroups?modifiedTimeStamp_gteq=2026-08-01

Groups modified within a date range:
GET /usersgroups?modifiedTimeStamp_gteq=2026-08-01&modifiedTimeStamp_lteq=2026-08-14

Groups last modified by a specific user (id 1234):
GET /usersgroups?modifiedBy_eq=1234
GET /usersgroupsusers JSON API endpoint returning the members of a group — filterable by group and by user, and pageable. Admin access only. Lets integrations see exactly who belongs to a group. Members of group 67:
GET /usersgroupsusers?usersGroup_eq=67
GET /api/rest/actions Adds a boolean isRestricted field to each record. External tools can spot restricted matters instantly, without a separate lookup. —
GET /api/rest/actions Adds RestrictedAccessUsers and RestrictedAccessUserGroups fields to each record. Shows precisely who can see a restricted matter — down to the individual and the group. —
(no endpoint — data behavior only) A group's LastModifiedDate now also updates when someone joins or leaves, not just on name/description changes. Ensures that the timestamp is something auditors and syncing tools (like Acumen) can rely on to detect changes.

Updated