---
title: "Updates the role of a project member of the project with the specified id."
method: POST
path: "/projects/{projectId}/updateprojectmember"
tags: ["projectMembers"]
---

# Updates the role of a project member of the project with the specified id.

`POST /projects/{projectId}/updateprojectmember`

Changes the role of a project member.
             The project member can also be set as a responsible project member, but only if no other member of this project is
             responsible.
             It is necessary that the project role is available in this project, otherwise the member cannot be updated.
             A project role is available when they are connected to the specified project type of the project.
            
             <Check title="Required Permissions" icon="key">The user has to be the creator or needs `project-master-data:manage` permissions on the project.</Check>

## Path parameters

- `projectId` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- ProjectMemberForm
  - `userId` string, uuid, required — The id of the member.
  - `projectRoleId` string, uuid, required — The id of the project role for this member.
  - `isResponsible` boolean — Whether the user should be marked as responsible.

## Response `200`

OK

- ProjectMember
  - `id` string, uuid — The id of the project member entity.
  - `userId` string, uuid — The id of the user who is this project member.
  - `firstName` string, nullable — The first name of the user.
  - `lastName` string, nullable — The last name of the user.
  - `hasImage` boolean, nullable — Whether the user has an image.
  - `projectRoleId` string, uuid — The project role of the project member.
  - `projectRoleName` string, nullable — The project role name of the project member.
  - `isResponsible` boolean — Whether the user is responsible for this project.
  - `isDeactivated` boolean — Whether the user is deactivated.
  - `isExternal` boolean — True if this entity is coming from an external workspace (awork Connect).

---

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