---
title: "Update project member list"
method: PUT
path: "/projects/{project_id}/project_members"
tags: ["project_members"]
---

# Update project member list

`PUT /projects/{project_id}/project_members`

Updates the project member list and membership level of users.

If you leave off a user who's already a member, the user's relationship to that project isn't changed.

If a specified user is already a member, the user's membership is changed to the specified level.

If a specified user is not already a member, the user is added with the specified level.

## Request body

- object
  - `relationships` array[] — An array of user ID and membership level pairs (tuples).
    - object[]

## Response `200`

The members of the matching project.

- object
  - `paging` PagingMetadata, required
    - `per_page` integer — The maximum number of items to show per response page.
    - `page` integer — The current response page number.
    - `previous` string, nullable — If you're on the first page, this value is `null`; otherwise the value is the path and query parameters to get the previous page of items.
    - `self` string — The path and query parameters to get the current page of items.
    - `next` string, nullable — If there are more items, this value is the path and query parameters to get the next page of items; otherwise, it's `null`.
    - `count` integer, nullable — The total number of items in all the pages.
  - `data` ProjectMember[], required
    - `id` integer — A unique identifier for the user.
    - `uid` string — A unique identifier for the user's project membership.
    - `name` string — The user's first and last name.
    - `license_type` 'licensed' — The user's license type.

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/resource-management-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/resource-management-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/resource-management-openapi-reference/versions/e4c439ac13f2/schema)