---
title: "Update a team membership"
method: PUT
path: "/team_memberships/{id}"
tags: ["team_memberships"]
---

# Update a team membership

`PUT /team_memberships/{id}`

Update a team membership. Access is only available to administrators or leaders of the associated team.
**Access policy**: administrator or leaders of the associated team

## Path parameters

- `id` integer, required

## Request body

- TeammembershipsTeamMembershipUpdatePayload
  - `Role` 1 | 2, required — Role for the user inside the team (1 for leader and 2 for regular member)
  - `TeamID` integer, required — Team identifier
  - `UserID` integer, required — User identifier

## Response `200`

Success

- PortainerTeamMembership
  - `Id` integer — Membership Identifier
  - `Role` 0 | 1 | 2
  - `TeamID` integer — Team identifier
  - `UserID` integer — User identifier

## Other responses

- `400` — Invalid request
- `403` — Permission denied
- `404` — TeamMembership not found
- `500` — Server error

---

[API](https://skmtc.net/portainer/apis/portainerce-api.md) · [All operations](https://skmtc.net/portainer/apis/portainerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/portainer/portainerce-api/versions/c0b0975cd11b/schema)