> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://contentful.com/developers/docs/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/_mcp/server. ## Group Space Members An individual user in your organization can be given access to a space *directly*, via a space membership, or *indirectly*, via their membership in a team that has itself been granted access via a team space membership. The access rights of a user in a space are calculated by combining the rights of *all* such memberships through which the user has derived access. Because this complex relationship between a user and a space can be difficult to reason about, the **space member** entity was developed. This entity reveals exactly which individual users have access to a space, and reveals their combined access rights within a single object. Furthermore, it provides a link to the related membership objects from which their access is derived. ### Get all space members in a space [Get all space members in a space](/references/user-management-api/space-members/get-all-space-members) This endpoint returns a paginated collection of all the space members in a space. This collection represents the set of all users in your organization who have access to the space. All space members can access this endpoint. #### Query Parameters | Name | Details | Description | | --------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `skip`, `limit` | - | Specify requested page of result set. See [Pagination](#/introduction/pagination) for more details. | | `include` | Supported values: `sys.user` | Specify linked resources to include in response. See [Including Related Resources](#/introduction/including-related-resources) for more details. | For the following response, the `SpaceMember` resources returned in `items` are the same for all requesters. When using `include=sys.user`, the included User resources may differ depending on the requester’s role in the space: * **Admin requesters** may receive full user information in `includes.User`. * **Non-admin requesters** may receive a reduced (minified) representation in `includes.User`. #### Response ```js { "total": 1, "limit": 25, "skip": 0, "sys": { "type": "Array" }, "items": [ { "sys": { "type": "SpaceMember", "id": "jn066pnp3hgr-7uqvFPPLzgtVaezGvjA9U6", "version": 1, "createdAt": "2013-04-11T20:04:37Z", "updatedAt": "2014-05-11T20:04:37Z", "space": { "sys": { "type": "Link", "linkType": "Space", "id": "jn066pnp3hgr" } }, "user": { "sys": { "type": "Link", "linkType": "User", "id": "7uqvFPPLzgtVaezGvjA9U6" } }, "relatedMemberships": [ { "sys": { "type": "Link", "linkType": "SpaceMembership", "id": "2G3gCn1mi1UHSBLTP2v4TI" } }, { "sys": { "type": "Link", "linkType": "TeamSpaceMembership", "id": "4FG3gCn1mi1UHSBLTP2v3GB" } } ] }, "admin": false, "roles": [ { "sys": { "type": "Link", "linkType": "Role", "id": "1ElgCn1mi1UHSBLTP2v4TD" } } ] } ] } ``` > **Info** > > When `include=sys.user` is specified, clients should not assume that all user attributes are always present in `includes.User`. The shape of included user data depends on the caller’s role in the space. ### Get a single space member [Get a single space member](/references/user-management-api/space-members/get-a-space-member) This endpoint returns the details of a space member. #### Response ```js { "sys": { "type": "SpaceMember", "id": "jn066pnp3hgr-7uqvFPPLzgtVaezGvjA9U6", "version": 1, "createdAt": "2013-04-11T20:04:37Z", "updatedAt": "2014-05-11T20:04:37Z", "space": { "sys": { "type": "Link", "linkType": "Space", "id": "jn066pnp3hgr" } }, "user": { "sys": { "type": "Link", "linkType": "User", "id": "7uqvFPPLzgtVaezGvjA9U6" } }, "relatedMemberships": [ { "sys": { "type": "Link", "linkType": "SpaceMembership", "id": "2G3gCn1mi1UHSBLTP2v4TI" } }, { "sys": { "type": "Link", "linkType": "TeamSpaceMembership", "id": "4FG3gCn1mi1UHSBLTP2v3GB" } } ] }, "admin": false, "roles": [ { "sys": { "type": "Link", "linkType": "Role", "id": "1ElgCn1mi1UHSBLTP2v4TD" } } ] } ``` ## API Docs - Space Members [Get all space members](https://contentful.com/developers/docs/references/user-management-api/space-members/get-all-space-members.md) - Space Members [Get a space member](https://contentful.com/developers/docs/references/user-management-api/space-members/get-a-space-member.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://contentful.com/developers/docs/openapi.json) - [OpenAPI YAML](https://contentful.com/developers/docs/openapi.yaml)