> 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 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
```