---
title: "Add Members to Project"
method: PUT
path: "/openapi/v2.0/project/member"
tags: ["Organization & Project/Members & Permissions Management/Project Members", "Organization & Project"]
---

# Add Members to Project

`PUT /openapi/v2.0/project/member`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/openapi/v2.0/project/member`
- Auth: none required

Add members to a project with a specific role; supports both add and update. Set the user key via the `X-User-Token` header, and the project UUID via the `X-Project-Uuid` header.
Pass `user_id` to add the member to the project corresponding to `X-Project-Uuid`.

:::tip[]
- For `user_id`, refer to the Authentication Tutorial to parse it from the JWT.
:::

## Headers

- `X-User-Token` string, required
- `X-Project-Uuid` string, required
- `X-Request-Id` string, uuid
- `X-Language` 'zh' | 'en'

## Request body

- object
  - `add_users` object[], required: Project member list to add/update this time; if user_id is already in the project, treated as update (only refreshes role and nickname); otherwise added as new
    - `user_id` string, required: DJI User ID; can be extracted from the user_id claim of the X-User-Token JWT
    - `role` 'project-member' | 'project-admin', required: Project role: project-admin=project administrator, project-member=regular member
    - `nickname` string: Display nickname in project; falls back to user's global nickname when not set

## Response `200`

- object
  - `code` integer, required: Non-zero Indicates Exception
  - `message` string, required: Message Prompt

## Other responses

- `400`: Invalid request parameters (incorrect format, missing required fields, etc.)
- `401`: Authentication failed (token invalid or expired)
- `403`: Insufficient permission (token does not have the corresponding permission in this project/organization)
- `500`: Server Internal Error

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-public-cloud/revisions/aeef0010be34?raw)