POST/Groups
신규 그룹을 추가한다. 설정할 수 있는 속성은 속성 매핑을 참고한다.
내부 그룹으로 추가된다.
메시지방 기능, 메일링리스트 기능은 모두 비활성화 된 상태로 추가된다.
구성원, 그룹 유형의 그룹 구성원만 추가할 수 있다. 조직 유형의 그룹 구성원은 추가할 수 없다.
SCIM Group API로 설정할 수 없는 속성(메시지방 기능, 메일링리스트, 공개여부 등)은 NAVER WORKS 서비스 내에서 그룹을 수정하거나 NAVER WORKS API를 사용해야 한다.
주의
- 그룹 추가/수정/부분 수정/삭제 API는 동일 그룹에 대하여 동시에 호출해서는 안 되며, 순서 대로 호출해야 한다.
| Header | type | Description |
|---|---|---|
| Authorization | string | Bearer {token} SCIM 전용 Long-Lived Token 발급 문서를 참고한다. required |
| Content-Type | string | application/json required |
| Property | Type | Description |
|---|---|---|
| schemas | array (string) | Schema URL required |
| externalId | string | SCIM 클라이언트 측에서 관리하는 ID |
| displayName | string | 그룹명 대소문자를 구분하지 않으며, 도메인 내에서 유일해야 한다. required maxLength : 100 |
| members | array (ScimGroupMember) | 그룹 구성원 목록 |
| Property | Type | Description |
|---|---|---|
| value | string | 그룹 구성원 ID(구성원 ID 또는 그룹 ID) required |
| Property | Type | Description |
|---|---|---|
| schemas | array (string) | Schema URL |
| id | string | 그룹 ID |
| externalId | string | SCIM 클라이언트 측에서 관리하는 ID |
| displayName | string | 그룹명 |
| members | array (ScimGroupMember) | 그룹 구성원 목록 |
| meta | object (meta) |
| Property | Type | Description |
|---|---|---|
| value | string | 그룹 구성원 ID(구성원 ID 또는 그룹 ID) required |
| type | string | 그룹 구성원 유형 Allowed values : USER, GROUP readOnly : true |
| display | string | 그룹 구성원 이름(구성원 이름 또는 그룹명) readOnly : true |
| $ref | string | 참조 URL 그룹 구성원의 상세 정보를 조회한다. readOnly : true |
| Property | Type | Description |
|---|---|---|
| resourceType | string | 리소스 유형 Allowed values : USER, GROUP |
| created | string | 생성일 |
| lastModified | string | 최근 수정일 |
| location | string | 리소스 URI |
Bad Request
Conflict