# 개별 권한 관리
## 개별 권한 저장
> \## 기능설명\
> \* 개별권한을 등록, 수정합니다.\
> \---\
> \## 상세설명\
> \* 기존 사용자는 수정, 신규 사용자는 등록이 진행됩니다.\
> \* 등록\
> \* 이미 개별권한을 갖고 있는 사용자는 등록이 불가합니다.\
> \* 팔수 값 목록\
> \* 유저 아이디\
> \* 적용 시작 일자\
> \* 적용 종료 일자\
> \* 수정\
> \* 필수 값 목록\
> \* 개별권한번호\
> \* 유저 아이디\
> \* 적용 시작 일자\
> \* 적용 종료 일자\
> \---\
> \## 수정번호\
> \* Release v2.00\_240617: 개별 권한 등록 적용 시작 일자, 적용 종료 일자 수정
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestStIndivRtBaseInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/StIndivRtBaseInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/StIndivRtBaseInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/StIndivRtBaseInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/StIndivRtBaseInfo"}}}},"StIndivRtBaseInfo":{"type":"object","description":"권한 대상 기본 Entity","properties":{"indivRtNo":{"type":"string","description":"개별권한번호"},"userId":{"type":"string","description":"사용자 아이디"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"useYn":{"type":"string","description":"사용여부"},"regCausCont":{"type":"string","description":"등록사유내용"},"atchFileRouteNm":{"type":"string","description":"첨부파일경로명(현재 미사용)"},"atchFileNm":{"type":"string","description":"첨부파일명(현재 미사용)"},"rtGrpNm":{"type":"string","description":"권한그룹명"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/system/individualRightMgmt/saveIndividualRightList":{"post":{"tags":["개별 권한 관리"],"summary":"개별 권한 저장","description":"## 기능설명\n* 개별권한을 등록, 수정합니다.\n---\n## 상세설명\n* 기존 사용자는 수정, 신규 사용자는 등록이 진행됩니다.\n* 등록\n * 이미 개별권한을 갖고 있는 사용자는 등록이 불가합니다.\n * 팔수 값 목록\n * 유저 아이디\n * 적용 시작 일자\n * 적용 종료 일자\n* 수정\n * 필수 값 목록\n * 개별권한번호\n * 유저 아이디\n * 적용 시작 일자\n * 적용 종료 일자\n---\n## 수정번호\n* Release v2.00_240617: 개별 권한 등록 적용 시작 일자, 적용 종료 일자 수정\n","operationId":"saveIndividualRightList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestStIndivRtBaseInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 버튼 권한 저장
> \## 기능설명\
> \* 버튼권한을 수정합니다.\
> \---\
> \## 상세설명\
> \* 사용자의 개별 개별 메뉴권한에 버튼권한 정보를 수정합니다.\
> \* 버튼권한 등록은 불가합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestStRtInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/StRtInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/StRtInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/StRtInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/StRtInfo"}}}},"StRtInfo":{"type":"object","description":"권한 정보 Entity","properties":{"rtGrpNo":{"type":"string","description":"권한그룹번호"},"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtSubGbCd":{"type":"string","description":"권한주체구분코드(UR006)"},"useYn":{"type":"string","description":"사용여부"},"groupYn":{"type":"string","description":"그룹권한 사용여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/individualRightMgmt/saveIndividualRightButtonGridList":{"post":{"tags":["개별 권한 관리"],"summary":"버튼 권한 저장","description":"## 기능설명\n* 버튼권한을 수정합니다.\n---\n## 상세설명\n* 사용자의 개별 개별 메뉴권한에 버튼권한 정보를 수정합니다.\n* 버튼권한 등록은 불가합니다.\n","operationId":"saveIndividualRightButtonGridList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestStRtInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 개별 권한 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 따라 개별 권한 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 화면에서 선택한 조건에 따라 개별 권한 목록을 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"IndividualRtInfoRequest":{"type":"object","properties":{"userId":{"type":"string"},"rtGrpNm":{"type":"string"},"rtGrpNo":{"type":"string"},"useYn":{"type":"string"}}},"RealGridListResponseIndividualRtInfoResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/IndividualRtInfoResponse"}}}},"IndividualRtInfoResponse":{"type":"object","description":"개별 권한 Response DTO","properties":{"indivRtNo":{"type":"string","description":"개별권한번호"},"userId":{"type":"string","description":"사용자 아이디"},"userNm":{"type":"string","description":"사용자 이름"},"sysGbCd":{"type":"string","description":"시스템 구분 코드(UR005)"},"sysGbCdNm":{"type":"string","description":"시스템 구분 코드명"},"rtGrpNm":{"type":"string","description":"권한그룹명"},"rtGrpNo":{"type":"string","description":"권한그룹번호"},"regCausCont":{"type":"string","description":"등록사유"},"aplyStrDt":{"type":"string","description":"적용 시작 일자"},"aplyEndDt":{"type":"string","description":"적용 종료 일자"},"useYn":{"type":"string","description":"사용 여부"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/system/individualRightMgmt/getIndividualRightList":{"get":{"tags":["개별 권한 관리"],"summary":"개별 권한 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 따라 개별 권한 목록을 조회합니다.\n---\n## 상세설명\n* 화면에서 선택한 조건에 따라 개별 권한 목록을 조회합니다.\n","operationId":"getIndividualRightList","parameters":[{"name":"individualRtInfoRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/IndividualRtInfoRequest"}},{"name":"userId","in":"query","description":"사용자 아이디","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"권한그룹명","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseIndividualRtInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 메뉴 권한 목록 조회
> \## 기능설명\
> \* 화면에서 선택한 조건에 사용자에 대한 메뉴 권한 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 메뉴 권한 목록은 트리 구조로 조회됩니다.\
> \* 개별권한기본정보 테이블에만 데이터 존재하고 권한정보엔 없는 상태는 권한대상기본에서 모든 메뉴 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RtTargetBaseRequest":{"type":"object","properties":{"sysGbCd":{"type":"string"},"rtTgtSeq":{"type":"string"},"uprRtTgtSeq":{"type":"string"},"userId":{"type":"string"},"rtGrpNo":{"type":"string"},"rtSubGbCd":{"type":"string"},"indivRtNo":{"type":"string"},"useYn":{"type":"string"}}},"ResponseListRtTargetBaseResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/RtTargetBaseResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RtTargetBaseResponse":{"type":"object","description":"메뉴 권한 Response DTO","properties":{"rtTgtSeq":{"type":"string","description":"권한대상순번"},"rtTgtNm":{"type":"string","description":"메뉴명"},"uprRtTgtSeq":{"type":"string","description":"상위권한대상순번"},"popupYn":{"type":"string","description":"팝업여부"},"level":{"type":"string","description":"레벨"},"hierarchy":{"type":"string","description":"트리 분류"},"uprRtTgtNm":{"type":"string","description":"상위권한대상명"},"sysGbCd":{"type":"string","description":"시스템구분코드(UR005)"},"rtTgtTypCd":{"type":"string","description":"권한대상유형코드(UR010)"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"callUrl":{"type":"string","description":"호출 URL"},"httpMethod":{"type":"string","description":"호출 URL"},"useYn":{"type":"string","description":"사용여부"},"rtSubGbCd":{"type":"string","description":"권한주체구분코드(UR006)"},"groupYn":{"type":"string","description":"그룹 권한 사용여부"},"custInfoInclYn":{"type":"string","description":"고객정보포함여부"},"rmkCont":{"type":"string","description":"비고내용"},"btnId":{"type":"string","description":"버튼 아이디"},"leafMenuYn":{"type":"string","description":"최하위 메뉴 여부"},"userHelpCont":{"type":"string","description":"사용자 도움말 내용"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/system/individualRightMgmt/getIndividualMenuTreeList":{"get":{"tags":["개별 권한 관리"],"summary":"메뉴 권한 목록 조회","description":"## 기능설명\n* 화면에서 선택한 조건에 사용자에 대한 메뉴 권한 목록을 조회합니다.\n---\n## 상세설명\n* 메뉴 권한 목록은 트리 구조로 조회됩니다.\n* 개별권한기본정보 테이블에만 데이터 존재하고 권한정보엔 없는 상태는 권한대상기본에서 모든 메뉴 조회합니다.\n","operationId":"getIndividualMenuTreeList","parameters":[{"name":"rtTargetBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseRequest"}},{"name":"rtSubGbCd","in":"query","description":"권한주체구분코드(UR006)","schema":{"type":"string"}},{"name":"rtGrpNo","in":"query","description":"권한그룹번호","schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListRtTargetBaseResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-9.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.