> 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 Team Memberships **Team memberships** represent the relationship between an organization member and a team within your organization. In other words, they are the data object that defines explicitly who is a member of a team. ### Get all team memberships in a team [Get all team memberships in a team](/references/user-management-api/team-memberships/get-all-team-memberships-for-a-team) This endpoint returns a paginated collection of all team memberships for this team. 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.createdAt`, `sys.updatedAt` | Specify sort order of result set. See [Sorting Results](#/introduction/#sorting-results) for more details. | | `include` | Supported values: `sys.createdBy`, `sys.updatedBy`, `sys.organizationMembership`, `sys.user` | Specify linked resources to include in response. See [Including Related Resources](#/introduction/including-related-resources) for more details. | #### Response ```js { "total": 1, "limit": 25, "skip": 0, "sys": { "type": "Array" }, "items": [ { "sys": { "type": "TeamMembership", "id": "5xKNPxTNPnKr8JHNHYbQeC", "organization": { "sys": { "type": "Link", "linkType": "Organization", "id": "4EJGvuLTBUMG2A6wS8gfAS" } }, "team": { "sys": { "type": "Link", "linkType": "Organization", "id": "4E6i5or8iabA6wS8gfASfa" } }, "createdAt": "4511-01-18T05:03:01.695Z", "updatedAt": "4203-08-22T19:00:01.887Z", "createdBy": { "sys": { "type": "Link", "linkType": "User", "id": "3Z6OpTgoCqMTwQ331UvyF4" } }, "updatedBy": { "sys": { "type": "Link", "linkType": "User", "id": "6i5or8iabD6qwHCK7JgGLn" } }, "organizationMembership": { "sys": { "type": "Link", "linkType": "OrganizationMembership", "id": "1UeTxCQ2SDqNgnE5zBvruF" } }, "user": { "sys": { "type": "Link", "linkType": "User", "id": "1VVPdngQPz6Qo5Qbba4zzY" } } } } ] } ``` ### Get all team memberships in an organization [Get all team memberships in an organization](/references/user-management-api/team-memberships/get-all-team-memberships-for-an-organization) This endpoint returns a paginated collection of all team memberships across all teams 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.createdAt`, `sys.updatedAt` | Specify sort order of result set. See [Sorting Results](#/introduction/sorting-results) for more details. | | `include` | Supported values: `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.organizationMembership.sys.id` | `eq`, `ne`, `in`, `nin` | String (id) | #### Response ```js { "total": 1, "limit": 25, "skip": 0, "sys": { "type": "Array" }, "items": [ { "sys": { "type": "TeamMembership", "id": "5xKNPxTNPnKr8JHNHYbQeC", "organization": { "sys": { "type": "Link", "linkType": "Organization", "id": "4EJGvuLTBUMG2A6wS8gfAS" } }, "team": { "sys": { "type": "Link", "linkType": "Organization", "id": "4E6i5or8iabA6wS8gfASfa" } }, "createdAt": "4511-01-18T05:03:01.695Z", "updatedAt": "4203-08-22T19:00:01.887Z", "createdBy": { "sys": { "type": "Link", "linkType": "User", "id": "3Z6OpTgoCqMTwQ331UvyF4" } }, "updatedBy": { "sys": { "type": "Link", "linkType": "User", "id": "6i5or8iabD6qwHCK7JgGLn" } }, "organizationMembership": { "sys": { "type": "Link", "linkType": "OrganizationMembership", "id": "1UeTxCQ2SDqNgnE5zBvruF" } }, "user": { "sys": { "type": "Link", "linkType": "User", "id": "1VVPdngQPz6Qo5Qbba4zzY" } } } } ] } ``` ### Get a team membership [Get a team membership](/references/user-management-api/team-memberships/get-a-team-membership) This endpoint returns details about an existing team membership. All organization members can access this endpoint. #### Response ```js { "sys": { "type": "TeamMembership", "id": "5xKNPxTNPnKr8JHNHYbQeC", "organization": { "sys": { "type": "Link", "linkType": "Organization", "id": "4EJGvuLTBUMG2A6wS8gfAS" } }, "team": { "sys": { "type": "Link", "linkType": "Organization", "id": "OpTgoCqMTwTBUMG2A6w7Jg" } }, "createdAt": "4511-01-18T05:03:01.695Z", "updatedAt": "4203-08-22T19:00:01.887Z", "createdBy": { "sys": { "type": "Link", "linkType": "User", "id": "3Z6OpTgoCqMTwQ331UvyF4" } }, "updatedBy": { "sys": { "type": "Link", "linkType": "User", "id": "6i5or8iabD6qwHCK7JgGLn" } }, "organizationMembership": { "sys": { "type": "Link", "linkType": "OrganizationMembership", "id": "1UeTxCQ2SDqNgnE5zBvruF" } }, "user": { "sys": { "type": "Link", "linkType": "User", "id": "1VVPdngQPz6Qo5Qbba4zzY" } } } } ``` ### Create a team membership [Create a team membership](/references/user-management-api/team-memberships/create-a-team-membership) This endpoint creates a new team membership in this team. Only organization admins and owners can access this endpoint. #### Request Body | Parameter | Type | Usage | | -------------------------- | ------ | -------- | | `organizationMembershipId` | string | required | #### Response ```js { "sys": { "type": "TeamMembership", "id": "5sjDwHAf1FRG65kPCwgzxc", "organization": { "sys": { "type": "Link", "linkType": "Organization", "id": "4EJGvuLTBUMG2A6wS8gfAS" } }, "team": { "sys": { "type": "Link", "linkType": "Organization", "id": "OpTgoCqMTwTBUMG2A6w7Jg" } }, "createdAt": "4471-03-29T09:18:21.619Z", "updatedAt": "4034-04-24T14:33:27.720Z", "createdBy": { "sys": { "type": "Link", "linkType": "User", "id": "5sjDwHAf1FRG65kPCwgzxc" } }, "updatedBy": { "sys": { "type": "Link", "linkType": "User", "id": "5sjDwHAf1FRG65kPCwgzxc" } }, "organizationMembership": { "sys": { "type": "Link", "linkType": "OrganizationMembership", "id": "2J75WDB0QSfoBCn2IYTXzm" } }, "user": { "sys": { "type": "Link", "linkType": "User", "id": "3sTeMpHKBy4Yycw6xmki6W" } } } } ``` ### Delete a team membership [Delete a team membership](/references/user-management-api/team-memberships/delete-a-team-membership) This endpoint deletes a team membership. Only organization admins and owners can access this endpoint. #### Response ```headers Status: 204 No Content ``` ## API Docs - Team Memberships [Get all team memberships for a team](https://contentful.com/developers/docs/references/user-management-api/team-memberships/get-all-team-memberships-for-a-team.md) - Team Memberships [Create a team membership](https://contentful.com/developers/docs/references/user-management-api/team-memberships/create-a-team-membership.md) - Team Memberships [Get all team memberships for an organization](https://contentful.com/developers/docs/references/user-management-api/team-memberships/get-all-team-memberships-for-an-organization.md) - Team Memberships [Get a team membership](https://contentful.com/developers/docs/references/user-management-api/team-memberships/get-a-team-membership.md) - Team Memberships [Delete a team membership](https://contentful.com/developers/docs/references/user-management-api/team-memberships/delete-a-team-membership.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)