Help Center/ CodeArts Req/ API Reference/ APIs/ Project members/ Adding Project Members in Batches

Updated on 2023-06-12 GMT+08:00

View PDF

Adding Project Members in Batches

Function

When you add project members in batches, only members under the same tenant as the project creator can be added. Incorrect user IDs will be skipped. If the added users exceed the permission, the default role is set to 7.

URI

POST /v4/projects/{project_id}/members

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Specifies the 32-bit ID of the devcloud project. Minimum: 32 Maximum: 32

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token. Minimum: 10 Maximum: 32768

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
users	Yes	Array of BatchAddMemberRequestV4 objects	Information about the added user

**Table 4** BatchAddMemberRequestV4
Parameter	Mandatory	Type	Description
role_id	No	Integer	Member Role, -1: project creator, 3 project manager, 4 developers, 5 test manager, 6 test personnel, 7 participant, 8 viewer, 9 O&M manager
user_id	Yes	String	32-bit UUID of a user.

Response Parameters

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_msg	String	Description
error_code	String	Error Codes

Status code: 401

**Table 6** Response body parameters
Parameter	Type	Description
error_msg	String	Description
error_code	String	Error Codes

Example Requests

POST https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/members

{
  "users" : [ {
    "user_id" : "665b542eb4c14b53a15ead449f28b0ba",
    "role_id" : 5
  } ]
}