Skip to main content

2026/06/30 - Manage users, seats, and roles with the mabl API

Molly Exten
  • Updated

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.

Accessing the account dashboard

Account-level endpoints require an account ID. You can obtain them from the account dropdown on the same dashboard:

Obtaining account IDs

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}/users returns every user across an account's workspaces, deduplicated, with account-scoped roles. Add the inactive filter (with an optional lookback_days window, 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}/activity returns 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}/seats returns allocated, used, and available seats for an account, split into automators and participants.
  • Get account seat usage: GET /accounts/{account_id}/seats/usage returns 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}/workspaces returns 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.

Related articles