특정 봇의 사용자 집합에 봇 역할을 할당합니다
이 API를 사용하려면 오직 봇 관리자 콘솔에서 생성된 애플리케이션에서 만들어진 JWT가 필요합니다. 이 API를 사용하려면 앱은 역할 관리 아래에 있는 역할 관리의 관리자 API 범위가 필요합니다.
POST https://{{host}}/api/public/btroles/assignments/
쿼리 매개 변수
| 매개 변수 | 필수/선택 사항 | 설명 |
|---|---|---|
| host | 필수 | 환경 URL(예: https://bots.kore.ai) |
본문 매개 변수
| 매개 변수 | 필수/선택 사항 | 설명 |
|---|---|---|
| roleId | 필수 | 사용자 또는 그룹을 할당할 봇 역할의 ID입니다. |
| botId | 필수 | 봇 역할을 할당할 봇의 ID입니다 |
| addUsers 또는 addOrgUserIds | 선택 사항 | 봇 역할을 할당할 사용자 이름 또는 조직 사용자 ID 목록 |
| removeUsers 또는 removeOrgUserIds | 선택 사항 | 봇 역할을 제거할 사용자 이름 또는 조직 사용자 ID 목록 |
| addGroups | 선택 사항 | 봇 역할을 할당할 그룹 이름 목록 |
| removeGroups | 선택 사항 | 봇 역할을 제거할 그룹 이름 목록 |
권한 부여
다음 구문을 포함한 헤더에 JWT를 포함한 API를 호출합니다. auth: {{JWT}}
콘텐츠 유형 응답
application/json
샘플 요청
curl -X POST \
https://{{host}}/api/public/btroles/assignments/' \
-H 'Content-Type: application/json' \
-H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
-d '[{
"roleId":"5bee8fv6729d35741e05aba4",
"botId":"{{botId}}",
"addUsers":[""],
"removeUsers":[""],
"addGroups": ["G2"],
"removeGroups":[""]
}]
샘플 응답
[
{
"status": "success "
}
]