---
title: "Batch Add Organization Members"
method: POST
path: "/openapi/v2.0/manage/api/v1/organizations/{uuid}/users"
tags: ["Organization & Project/Members & Permissions Management/Organization Members"]
---

# Batch Add Organization Members

`POST /openapi/v2.0/manage/api/v1/organizations/{uuid}/users`

## Request

- Base URL: `https://41b04hdzmc.apifox.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://41b04hdzmc.apifox.cn/openapi/v2.0/manage/api/v1/organizations/{uuid}/users`
- Auth: none required

Organization administrator batch-adds members (accounts must be registered in user center). **Protection Mechanisms**:
- **Brute-force Guess Protection**: When same operator accumulates ≥3 "account not found" failures within 5 minutes, triggers cooldown; entire batch is rejected
- **Entitlement Check**: In some deployment environments, checks user quota subscription first **Error Cases** (returned independently per entry):
- Account already in organization
- Specified role is invalid
- Rate limit triggered

## Path parameters

- `uuid` string, required

## Headers

- `x-user-token` string, required
- `X-Request-Id` string, uuid
- `X-Project-Uuid` string, required

## Request body

- object
  - `users` object[]: Member List to Add
    - `account` string, required: Member Account (Phone/Email)
    - `nickname` string, required: Member Organization Call Sign
    - `role` string, required: Member Organization Role (e.g. commander/member/device_manager)
    - `user_id` string: Existing User's user_id (Optional, lookup by user_id preferentially)

## Response `200`

OK. **Rate Limit**: When deployment-level switch `org_add_user_rate_limit` is enabled, each organization has 5-minute cooldown. **Key Error Codes** (in `data.error_infos[].error_code`): `Account Not Found` / `Already Member` / `Invalid Role`.

- object
  - `code` integer, required: Business Status Code: 0=Success; non-zero=Error Code (see message for meaning)
  - `message` string: Error Description Message (Omitted on Success)
  - `data` unknown

## Other responses

- `500`: Service temporarily unavailable, please retry later

---

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