> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/back-office-api-reference/system-bo-api/individual-permission-management.md).

# Individual Permission Management

## Save Individual Permission

> \## Function Description\
> \* Registers and modifies individual permissions.\
> \---\
> \## Detailed Description\
> \* Existing users are modified, and new users are registered.\
> \* Registration\
>    \* A user who already has an individual permission cannot be registered.\
>    \* Required Value List\
>       \* User ID\
>       \* Application Start Date\
>       \* Application End Date\
> \* Modification\
>    \* Required Value List\
>       \* Individual Permission No.\
>       \* User ID\
>       \* Application Start Date\
>       \* Application End Date\
> \---\
> \## Revision History\
> \* Release v2.00\_240617: Modified application start date and application end date for individual permission registration<br>

```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":"Permission Target Basic Entity","properties":{"indivRtNo":{"type":"string","description":"Individual Authorization No."},"userId":{"type":"string","description":"User ID"},"sysGbCd":{"type":"string","description":"System Classification Code (UR005)"},"aplyStrDt":{"type":"string","description":"Application Start Date"},"aplyEndDt":{"type":"string","description":"Application End Date"},"useYn":{"type":"string","description":"Usage Status"},"regCausCont":{"type":"string","description":"Registration Reason Content"},"atchFileRouteNm":{"type":"string","description":"Attachment File Path (Currently Unused)"},"atchFileNm":{"type":"string","description":"Attachment File Name (Currently Unused)"},"rtGrpNm":{"type":"string","description":"Authorization Group Name"}}},"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":["Individual Permission Management"],"summary":"Save Individual Permission","description":"## Function Description\n* Registers and modifies individual permissions.\n---\n## Detailed Description\n* Existing users are modified, and new users are registered.\n* Registration\n   * A user who already has an individual permission cannot be registered.\n   * Required Value List\n      * User ID\n      * Application Start Date\n      * Application End Date\n* Modification\n   * Required Value List\n      * Individual Permission No.\n      * User ID\n      * Application Start Date\n      * Application End Date\n---\n## Revision History\n* Release v2.00_240617: Modified application start date and application end date for individual permission registration\n","operationId":"saveIndividualRightList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestStIndivRtBaseInfo"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Save Button Permission

> \## Function Description\
> \* Modifies a button permission.\
> \---\
> \## Detailed Description\
> \* Modifies the button permission information for a user's individual menu permission.\
> \* Button permission registration is not possible.<br>

```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":"Permission Information Entity","properties":{"rtGrpNo":{"type":"string","description":"Authorization Group No."},"rtTgtSeq":{"type":"string","description":"Authorization Target Sequence No."},"rtSubGbCd":{"type":"string","description":"Permission Subject Type Code (UR006)"},"useYn":{"type":"string","description":"Usage Status"},"groupYn":{"type":"string","description":"Group Permission Usage Status"}}},"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":["Individual Permission Management"],"summary":"Save Button Permission","description":"## Function Description\n* Modifies a button permission.\n---\n## Detailed Description\n* Modifies the button permission information for a user's individual menu permission.\n* Button permission registration is not possible.\n","operationId":"saveIndividualRightButtonGridList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestStRtInfo"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Individual Permission List

> \## Function Description\
> \* Retrieves the individual permission list according to the conditions selected on the screen.\
> \---\
> \## Detailed Description\
> \* Retrieves the individual permission list according to the conditions selected on the screen.<br>

```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":"Individual Permission Response DTO","properties":{"indivRtNo":{"type":"string","description":"Individual Authorization No."},"userId":{"type":"string","description":"User ID"},"userNm":{"type":"string","description":"User Name"},"sysGbCd":{"type":"string","description":"System Type Code (UR005)"},"sysGbCdNm":{"type":"string","description":"System Type Code Name"},"rtGrpNm":{"type":"string","description":"Authorization Group Name"},"rtGrpNo":{"type":"string","description":"Authorization Group No."},"regCausCont":{"type":"string","description":"Registration Reason"},"aplyStrDt":{"type":"string","description":"Applicable Start Date"},"aplyEndDt":{"type":"string","description":"Applicable End Date"},"useYn":{"type":"string","description":"Usage Status"}}},"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":["Individual Permission Management"],"summary":"Retrieve Individual Permission List","description":"## Function Description\n* Retrieves the individual permission list according to the conditions selected on the screen.\n---\n## Detailed Description\n* Retrieves the individual permission list according to the conditions selected on the screen.\n","operationId":"getIndividualRightList","parameters":[{"name":"individualRtInfoRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/IndividualRtInfoRequest"}},{"name":"userId","in":"query","description":"User ID","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"Authorization Group Name","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseIndividualRtInfoResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Menu Permission List

> \## Function Description\
> \* Retrieves the menu permission list for the user matching the conditions selected on the screen.\
> \---\
> \## Detailed Description\
> \* The menu permission list is retrieved in a tree structure.\
> \* If data exists only in the Individual Permission Basic Information table and not in the permission information, all menus are retrieved from the Permission Target Basic Information.<br>

```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":"Menu Permission Response DTO","properties":{"rtTgtSeq":{"type":"string","description":"Authorization Target Sequence No."},"rtTgtNm":{"type":"string","description":"Menu Name"},"uprRtTgtSeq":{"type":"string","description":"Parent Authorization Target Sequence No."},"popupYn":{"type":"string","description":"Popup Status"},"level":{"type":"string","description":"Level"},"hierarchy":{"type":"string","description":"Tree Classification"},"uprRtTgtNm":{"type":"string","description":"Parent Authority Target Name"},"sysGbCd":{"type":"string","description":"System Classification Code (UR005)"},"rtTgtTypCd":{"type":"string","description":"Authorization Target Type Code (UR010)"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"callUrl":{"type":"string","description":"Call URL"},"httpMethod":{"type":"string","description":"Call URL"},"useYn":{"type":"string","description":"Usage Status"},"rtSubGbCd":{"type":"string","description":"Permission Subject Type Code (UR006)"},"groupYn":{"type":"string","description":"Group Authorization Usage Status"},"custInfoInclYn":{"type":"string","description":"Include Customer Information Status"},"rmkCont":{"type":"string","description":"Remarks"},"btnId":{"type":"string","description":"Button ID"},"leafMenuYn":{"type":"string","description":"Lowest-Level Menu Status"},"userHelpCont":{"type":"string","description":"User Help Content"}}},"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":["Individual Permission Management"],"summary":"Retrieve Menu Permission List","description":"## Function Description\n* Retrieves the menu permission list for the user matching the conditions selected on the screen.\n---\n## Detailed Description\n* The menu permission list is retrieved in a tree structure.\n* If data exists only in the Individual Permission Basic Information table and not in the permission information, all menus are retrieved from the Permission Target Basic Information.\n","operationId":"getIndividualMenuTreeList","parameters":[{"name":"rtTargetBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RtTargetBaseRequest"}},{"name":"rtSubGbCd","in":"query","description":"Permission Subject Type Code (UR006)","schema":{"type":"string"}},{"name":"rtGrpNo","in":"query","description":"Authorization Group No.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListRtTargetBaseResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```