List group members
Changed on<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>
Returns one page of a group's members, sorted by email. Set search to match part of a member's email or name.
To page, keep requesting with offset increased by the number of members returned while has_more is true.
Members your identity provider sent who don't have a Base44 account in the workspace yet aren't listed. List workspace groups counts them in unresolved_count.
This is limited to 120 requests per minute, shared with List workspace groups. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.
<Note>Call this as an owner, admin, or editor of the workspace, with a personal access token for that workspace sent as a Bearer token, or from a signed-in session. A read-only token is accepted, but workspace API keys aren't.</Note>
Request
- Base URLhttps://app.base44.com
- URLhttps://app.base44.com/api/workspace/groups/{group_id}/members
- AuthHTTP bearer
Path parameters
ID of the group whose members to list. Get it from id in List workspace groups.
Query parameters
ID of the workspace. With a personal access token, use the token's workspace. Get it from organization_id in Get app.
Only return members whose email or name contains this text, ignoring case. Up to 254 characters.
Number of members to skip. Defaults to 0.
Number of members to return, from 1 to 200. Defaults to 50.
Response
One page of the group's members.
Example response
{
"members": [
{
"email": "dana@acme.com",
"full_name": "Dana Levi",
"user_id": "6820f41be7b91d003c45a20a"
}
],
"total": 12
}Changes
- breaking
queryrequest parametersearchlist-of-types was narrowed by removing typesnull - warning
for the
queryrequest parametersearch, the maxLength was set to254 - info
for the
queryrequest parametersearch, the type was generalized from no type tostring
- breaking
- info
the security scope
read_onlywas added to the endpoint's security schemePersonalAccessTokenAuth - info
the security scope
full_accesswas removed from the endpoint's security schemePersonalAccessTokenAuth
- info