List workspace members
Retrieve a list of all accepted members in your workspace using the Lovable API. You can search by member name or email, filter by role, and page through large teams.
Teams on a Business plan or higher who want to build a member directory or audit workspace users inside their app.
Do this, in order
- 1
Create an API key in Lovable settings with the workspaces:read or workspaces:write scope.
The endpoint requires proper permissions and will return a 403 error without this scope.
- 2
Store your API key and workspace ID securely in your project's backend environment variables.
Keeping credentials on the backend protects your workspace access from being exposed in browser code.
- 3
Send an HTTP GET request to https://api.lovable.dev/v1/workspaces/{workspace_id}/members with your key in the Lovable-API-Key header.
This fetches the first page of active members including their display names, roles, and user IDs.
- 4
Fetch additional pages by passing pagination.next_cursor as the cursor query parameter without modifying your existing filter or sort options.
Cursors are locked to the specific filters used when created, and changing parameters will cause the request to fail.
Paste this into your project
Create a backend server route and a frontend team management page that fetches and displays our Lovable workspace members. Call the GET https://api.lovable.dev/v1/workspaces/{workspace_id}/members endpoint using our LOVABLE_API_KEY from environment variables. Include a search bar that only triggers search when at least 3 characters are typed, a dropdown to filter by role, and pagination controls that use the returned next_cursor while preserving the current search filters.Words decoded
- cursor
- A unique marker returned by an API that tells the server where to pick up when loading the next page of results.
- eventually consistent
- A setup where updates take a few moments to sync everywhere, meaning newly added members might not appear immediately in the list.
- SCIM
- An automated enterprise tool that synchronizes employee accounts between a company directory and external software.
Where people get stuck
- Do not alter search parameters, filters, or sorting when requesting the next page with a cursor, or the API will return a 400 error.
- Search terms shorter than 3 characters are silently ignored.
- This endpoint is restricted to Business plans and higher; lower tiers will receive a payment required error.
- Recent changes may take a brief moment to show up; if an updated member is missing, retry the request after a short delay.
The short version, steps, decoder and prompt on this page are written automatically from Lovable's own documentation and can lag or misread it. The official page is always the authority.