The mabl API now includes endpoints for managing workspace membership and reviewing user activity and seat usage across an account. Use them to automate user provisioning and offboarding, reclaim unused licenses, and build custom governance dashboards.
Before you start
User and workspace management endpoints require a company-scoped "User management" API key. Admins can create one from the API keys section of the account dashboard.
Account-level endpoints require an account ID. You can obtain them from the account dropdown on the same dashboard:
Workspace IDs can be obtained from Settings > Workspace in the app.
Manage workspace membership
-
Update a member's role:
PATCH /workspaces/{workspace_id}/users/{id}changes an existing member's role in a workspace. -
Remove a member:
DELETE /workspaces/{workspace_id}/users/{id}removes a member from a workspace.
Use query users to get user IDs for these endpoints.
Both endpoints support If-Match for safe concurrent updates and protect the last owner of a workspace from being demoted or removed. Connect them to your identity management tools to automate role assignments and offboarding.
Review users across an account
-
List account users:
GET /accounts/{account_id}/usersreturns every user across an account's workspaces, deduplicated, with account-scoped roles. Add theinactivefilter (with an optionallookback_dayswindow, default 90) to return only users with no recent activity, which makes it easy to spot licenses you can reclaim. -
Get an account user:
GET /accounts/{account_id}/users/{id}looks up a single user's roles within an account. -
Get account user activity:
GET /accounts/{account_id}/users/{id}/activityreturns one user's activity across all account workspaces, including last-active time, total actions, and a per-workspace breakdown.
Track seat usage
-
Get account seats:
GET /accounts/{account_id}/seatsreturns allocated, used, and available seats for an account, split into automators and participants. -
Get account seat usage:
GET /accounts/{account_id}/seats/usagereturns per-user seat utilization for a given month, classifying each user as an automator or participant.
Use these endpoints to manage your ratio of automators to participants and right-size your account without manual audits.
List a company's workspaces
-
List company workspaces:
GET /companies/{id}/workspacesreturns every workspace in a company, grouped by the owning account.
Use this endpoint to build a complete inventory of your company's workspaces for governance reporting.
Learn more
Explore sample API workflows for account and user management in the docs.