Help Center/ CodeArts Repo/ API Reference/ APIs/ V4/ Group/ Associating a Repository Group with a Member Group
Updated on 2026-04-28 GMT+08:00
View PDF

Associating a Repository Group with a Member Group

Function

This API is used to associate a repository group with a member group.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

POST https://{hostURL}/v4/{project_id}/groups/{group_id}/user-group/{user_group_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition:

You can obtain the unique project identifier, 32-character UUID, by calling the API used to query the project list.

Value range:

32 characters

group_id

Yes

Integer

Definition

Repository group ID, which is the numeric ID next to Group ID on the repository group homepage.

Value range:

1~2147483647

user_group_id

Yes

String

Definition

Member group ID.

Range

String length: 32 characters.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition

User token. Obtain a token by calling the IAM API for obtaining a user token. The value of X-Subject-Token in the response header is the user token.

Constraints

Mandatory.

Range

1–100,000 characters.

Default Value

N/A.

Response Parameters

Status code: 201

Table 3 Response body parameters

Parameter

Type

Description

success

Array of MemberBaseDto objects

Associated members

failure

Array of FailureForBatchCreateGroupMembersDto objects

Members that failed to be associated
Table 4 MemberBaseDto

Parameter

Type

Description

id

String

User ID

iam_id

String

iam_id

name

String

Member name
Table 5 FailureForBatchCreateGroupMembersDto

Parameter

Type

Description

iam_id

String

iam_id

message

Array of strings

Failure cause

Status code: 401

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Definition

Error code.

error_msg

String

Definition

Error message.

Example Requests

/v4/5109940fad834a4eb3e408182d3b5786/groups/2111717210/user-group/2bde30f6f7834db7af487450a9d155c5

Example Responses

Status code: 201

OK

{
  "success" : [ {
    "id" : 10091,
    "name" : "paas_codeartsrepo_f30041672_01",
    "iam_id" : "4a7049ad346d43419328a37b93b38ad4"
  }, {
    "id" : 9443,
    "name" : "example_name",
    "iam_id" : "4a7049ad346d43419328a37b93b38ad4"
  }, {
    "id" : 9405,
    "name" : "example_name",
    "iam_id" : "4a7049ad346d43419328a37b93b38ad4"
  } ],
  "failure" : [ ]
}

Status code: 401

Unauthorized

{
  "error_code" : "DEV.00000003",
  "error_msg" : "Authentication information expired."
}

Status Codes

Status Code

Description

201

OK

401

Unauthorized

Error Codes

See Error Codes.

Parent topic: Group