멤버 수정¶
POST /api/v1/workspace/member/batch_modify
개요¶
하나 이상의 멤버 수정
Body 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| accountUUIDs | array | Y | 계정 목록 예시: ['워크스페이스에 추가되지 않은 계정 UUID1', '워크스페이스에 추가되지 않은 계정 UUID2'] 빈 값 허용: True |
| roleUUIDs | array | Y | 사용자 역할 UUID 목록 예시: None 빈 값 허용: False |
| onlyModifyRoles | boolean | Y | 멤버 역할만 수정할지 여부, True인 경우 팀 정보를 수정하지 않음 예시: True 빈 값 허용: False |
| memberGroupUUIDs | array | 팀 목록 예시: ['xxx', 'xxx'] 빈 값 허용: True |
|
| acntWsNickname | string | 해당 워크스페이스에서의 계정 닉네임 예시: 닉네임 AAA 빈 값 허용: True $maxCustomLength: 128 |
매개변수 추가 설명¶
데이터 설명.*
멤버 역할 수정 시, roleUUIDs에 Token 승인이 필요한 역할이 포함된 경우(SaaS 무료 플랜, PaaS 플랜은 청구 센터 승인 불필요) 반드시 승인이 필요 없는 역할 UUID도 포함해야 합니다.
- 요청 매개변수 설명
| 매개변수명 | type | 설명 |
|---|---|---|
| accountUUIDs | list | 멤버 계정 UUID |
| roleUUIDs | list | 역할 UUID |
| onlyModifyRoles | boolean | 역할 정보만 변경할지 여부(true: 일괄 수정, false: 개별 수정) |
| memberGroupUUIDs | list | 개별 멤버 수정 시 팀 정보 필수 전달 |
| acntWsNickname | string | 워크스페이스에서의 계정 닉네임 |
요청 예시¶
curl 'https://openapi.guance.com/api/v1/workspace/member/batch_modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"accountUUIDs": ["acnt_xxxx32"], "onlyModifyRoles": true, "roleUUIDs": ["general","wsAdmin"]}' \
--compressed
응답¶
{
"code": 200,
"content": {
"autoLoginUrl": "http://testing-zc-portal.cloudflux.cn/#/signin?from=http:%2F%2Ftesting-zc-portal.cloudflux.cn%2Fportal.html%23%2Finfo%2Flist&ticket=7d628f01-6c63-454a-8cf7-7c30678a9b0d"
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-F0E7FBC3-3A2B-4843-9B5E-DAD070AB812B"
}