> 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/developers/docs/_mcp/server. ## Group Team Space Memberships **Team space memberships** are just like space memberships, except that while space memberships grant space access to a single user, team space memberships grant access to an entire team. ### Get all team space memberships in a space [Get all team space memberships in a space](/references/user-management-api/team-space-memberships/get-all-team-space-memberships-for-a-space) This endpoint returns a paginated collection of all team space memberships for this space. Only organization admins, owners, and space admins can access this endpoint. #### Query Parameters | Name | Details | Description | | --------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `skip`, `limit` | - | Specify requested page of result set. See [Pagination](#/introduction/pagination) for more details. | | `order` | Supported values: `sys.updatedAt`, `sys.createdAt` | Specify sort order of result set. See [Sorting Results](#/introduction/sorting-results) for more details. | | `include` | Supported values: `roles`, `sys.team` | Specify linked resources to include in response. See [Including Related Resources](#/introduction/including-related-resources) for more details. | | Filters | See section below | Specify a value to filter against for the provided attribute. See [Filtering Results](#/introduction/filtering-results) for more information, and below for details about supported attributes for this endpoint. | #### Filter Parameters See [Filtering Results](#/introduction/filtering-results) for details about how to use attributes and operators to construct query filters. | Attribute | Supported Operators | Supported Values | | --------- | ------------------- | ---------------- | | `sys.id` | `eq`, `in` | String (id) | #### Response ```js { "total": 1, "limit": 25, "skip": 0, "sys": { "type": "Array" }, "items": [ { "sys": { "type": "TeamSpaceMembership", "id": "0xWanD4AZI2AR35wW9q51n", "version": 0, "createdAt": "2015-05-18T11:29:46.809Z", "createdBy": { "sys": { "type": "Link", "linkType": "User", "id": "7BslKh9TdKGOK41VmLDjFZ" } }, "updatedAt": "2015-05-18T11:29:46.809Z", "updatedBy": { "sys": { "type": "Link", "linkType": "User", "id": "4FLrUHftHW3v2BLi9fzfjU" } }, "team": { "sys": { "type": "Link", "linkType": "Team", "id": "7BslKh9TdKGOK41VmLDjFZ" } }, "space": { "sys": { "type": "Link", "linkType": "Space", "id": "jn066pnp3hgr" } } }, "admin": false, "roles": [ { "sys": { "type": "Link", "linkType": "Role", "id": "1ElgCn1mi1UHSBLTP2v4TD" } } ] } ] } ``` ### Get all team space memberships in an organization [Get all team space memberships in an organization](/references/user-management-api/team-space-memberships/get-all-team-space-memberships-for-an-organization) This endpoint returns a paginated collection of all team space memberships across all spaces in the organization. All organization 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. | | `order` | Supported values: `sys.updatedAt`, `sys.createdAt` | Specify sort order of result set. See [Sorting Results](#/introduction/sorting-results) for more details. | | `include` | Supported values: `roles`, `sys.createdBy`, `sys.updatedBy`, `sys.space`, `sys.team` | Specify linked resources to include in response. See [Including Related Resources](#/introduction/including-related-resources) for more details. | | Filters | See section below | Specify a value to filter against for the provided attribute. See [Filtering Results](#/introduction/filtering-results) for more information, and below for details about supported attributes for this endpoint. | #### Filter Parameters See [Filtering Results](#/introduction/filtering-results) for details about how to use attributes and operators to construct query filters. | Attribute | Supported Operators | Supported Values | | ------------------ | -------------------------------- | ---------------- | | `roles.name` | `eq`, `ne`, `in`, `nin` | String | | `roles.sys.id` | `eq`, `in` | String (id) | | `sys.createdAt` | `lt`, `lte`, `gt`, `gte` | Datetime string | | `sys.updatedAt` | `lt`, `lte`, `gt`, `gte` | Datetime string | | `sys.team.sys.id` | `eq`, `ne`, `in`, `nin` | String (id) | | `sys.space.name` | `eq`, `ne`, `in`, `nin`, `match` | String | | `sys.space.sys.id` | `eq`, `ne`, `in`, `nin` | String (id) | #### Response ```js { "total": 1, "limit": 25, "skip": 0, "sys": { "type": "Array" }, "items": [ { "sys": { "type": "TeamSpaceMembership", "id": "0xWanD4AZI2AR35wW9q51n", "version": 0, "createdAt": "2015-05-18T11:29:46.809Z", "createdBy": { "sys": { "type": "Link", "linkType": "User", "id": "7BslKh9TdKGOK41VmLDjFZ" } }, "updatedAt": "2015-05-18T11:29:46.809Z", "updatedBy": { "sys": { "type": "Link", "linkType": "User", "id": "4FLrUHftHW3v2BLi9fzfjU" } }, "team": { "sys": { "type": "Link", "linkType": "Team", "id": "7BslKh9TdKGOK41VmLDjFZ" } }, "space": { "sys": { "type": "Link", "linkType": "Space", "id": "jn066pnp3hgr" } } }, "admin": false, "roles": [ { "sys": { "type": "Link", "linkType": "Role", "id": "1ElgCn1mi1UHSBLTP2v4TD" } } ] } ] } ``` ### Get a single team space membership [Get a single team space membership (space-scoped)](/references/user-management-api/team-space-memberships/get-a-team-space-membership-for-a-space) [Get a single team space membership (organization-scoped)](/references/user-management-api/team-space-memberships/get-a-team-space-membership-for-an-organization) These endpoints return details about an existing team space membership. The first endpoint (scoped to a space) is accessible to all space members; the second (scoped to an organization) is accessible to all organization members. #### Response ```js { "sys": { "type": "TeamSpaceMembership", "id": "0xWanD4AZI2AR35wW9q51n", "version": 0, "createdAt": "2015-05-18T11:29:46.809Z", "createdBy": { "sys": { "type": "Link", "linkType": "User", "id": "7BslKh9TdKGOK41VmLDjFZ" } }, "updatedAt": "2015-05-18T11:29:46.809Z", "updatedBy": { "sys": { "type": "Link", "linkType": "User", "id": "4FLrUHftHW3v2BLi9fzfjU" } }, "team": { "sys": { "type": "Link", "linkType": "Team", "id": "7BslKh9TdKGOK41VmLDjFZ" } }, "space": { "sys": { "type": "Link", "linkType": "Space", "id": "jn066pnp3hgr" } } }, "admin": false, "roles": [ { "sys": { "type": "Link", "linkType": "Role", "id": "1ElgCn1mi1UHSBLTP2v4TD" } } ] } ``` ### Create a team space membership [Create a team space membership](/references/user-management-api/team-space-memberships/create-a-team-space-membership) Use this endpoint to create a team space membership. A team can either be designated as an admin or assigned to one or more roles. All active members of the team will inherit these permissions. Only organization admins, owners, and space admins can access this endpoint. #### Request Headers | Parameter | Type | Usage | | ------------------- | ------ | -------------------------------------------------- | | `X-Contentful-Team` | string | required; the `id` of the team for this membership | #### Request Body | Parameter | Type | Usage | | --------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- | | `admin` | boolean | required | | `roles` | array(Role) | required; must contain at least one role if admin is `false` (see also [Roles](/references/content-management-api/overview)) | #### Response ```js { "sys": { "type": "TeamSpaceMembership", "id": "0xWanD4AZI2AR35wW9q51n", "version": 0, "createdAt": "2015-05-18T11:29:46.809Z", "createdBy": { "sys": { "type": "Link", "linkType": "User", "id": "7BslKh9TdKGOK41VmLDjFZ" } }, "updatedAt": "2015-05-18T11:29:46.809Z", "updatedBy": { "sys": { "type": "Link", "linkType": "User", "id": "4FLrUHftHW3v2BLi9fzfjU" } }, "team": { "sys": { "type": "Link", "linkType": "Team", "id": "7BslKh9TdKGOK41VmLDjFZ" } }, "space": { "sys": { "type": "Link", "linkType": "Space", "id": "jn066pnp3hgr" } } }, "admin": false, "roles": [ { "sys": { "type": "Link", "linkType": "Role", "id": "1ElgCn1mi1UHSBLTP2v4TD" } } ] } ``` ### Update a team space membership [Update a team space membership](/references/user-management-api/team-space-memberships/update-a-team-space-membership) This endpoint updates a team space membership. Use this to change the roles for a team or make the team an admin within the space. Only organization admins, owners, and space admins can access this endpoint. #### Request Body | Parameter | Type | Usage | | --------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- | | `admin` | boolean | required | | `roles` | array(Role) | required; must contain at least one role if admin is `false` (see also [Roles](/references/content-management-api/overview)) | #### Response ```js { "sys": { "type": "TeamSpaceMembership", "id": "362gCn1mi1UHSBLTP2v4TD", "version": 0, "createdAt": "3899-05-25T21:00:34.690Z", "createdBy": { "sys": { "type": "Link", "linkType": "User", "id": "1ElgCn1mi1UHSBLTP2v4TD" } }, "updatedAt": "3089-09-11T13:51:59.504Z", "updatedBy": { "sys": { "type": "Link", "linkType": "User", "id": "1ElgCn1mi1UHSBLTP2v4TD" } }, "team": { "sys": { "type": "Link", "linkType": "Team", "id": "gCn1mi1El1UHSBLTP2v4TD" } }, "space": { "sys": { "type": "Link", "linkType": "Space", "id": "5ae45h2qifno" } } }, "admin": false, "roles": [ { "sys": { "type": "Link", "linkType": "Role", "id": "1ElgCn1mi1UHSBLTP2v4TD" } }, { "sys": { "type": "Link", "linkType": "Role", "id": "54gtw51mi1UHSBLTP2v4TD" } } ] } ``` ### Delete a team space membership [Delete a team space membership](/references/user-management-api/team-space-memberships/delete-a-team-space-membership) This endpoint deletes a team space membership. Only organization admins, owners, and space admins can access this endpoint. #### Response ```headers Status: 204 No Content ```