> 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/permission-group-management.md).
# Permission Group Management
## Save Permission Group Button Permissions
> \## Function Description\
> \* Saves the button permissions of the menu permission selected on the screen.\
> \---\
> \## Detailed Description\
> \* Saves the button permissions of the menu permission selected on the screen.
```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":{"RightTargetBaseMenuRequest":{"type":"object","description":"Permission Group Button Request DTO","properties":{"rtGrpNo":{"type":"string","description":"Authorization Group No."},"rootRtGrpNo":{"type":"string","description":"Top-Level Authorization Group No."},"rtTgtSeq":{"type":"string","description":"Permission Target Sequence No."},"rtTgtTypCd":{"type":"string","description":"Authorization Target Type Code (UR010)"},"rtSubGbCd":{"type":"string","description":"Authorization Subject Type Code (UR006)"},"sysGbCd":{"type":"string","description":"System Classification Code (UR005)"},"useYn":{"type":"string","description":"Usage Status"},"uprRtTgtSeq":{"type":"string","description":"Parent Authorization Target Sequence No."}}},"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/rightGroupMgmt/saveRightTargetBaseMenu":{"post":{"tags":["Permission Group Management"],"summary":"Save Permission Group Button Permissions","description":"## Function Description\n* Saves the button permissions of the menu permission selected on the screen.\n---\n## Detailed Description\n* Saves the button permissions of the menu permission selected on the screen.\n","operationId":"saveRightTargetBaseMenu","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RightTargetBaseMenuRequest"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Save Permission Group
> \## Function Description\
> \* Registers, modifies, and deletes permission group information.\
> \---\
> \## Detailed Description\
> \* Processes the registration, modification, and deletion information received all at once from the grid on the screen.\
> \* Required Value List\
> \* Permission Group No.\
> \* Permission Group Name\
> \* System Type Code\
> \* Application Start Date\
> \* Application End Date\
> \* Usage Status\
> \* Modifier ID
```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":{"RealGridCUDRequestRightGroupBaseRequest":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseRequest"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseRequest"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseRequest"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseRequest"}}}},"RightGroupBaseRequest":{"type":"object","properties":{"rtGrpNo":{"type":"string"},"sysGbCd":{"type":"string"},"rtGrpNm":{"type":"string"},"aplyStrDt":{"type":"string"},"aplyEndDt":{"type":"string"},"useYn":{"type":"string"}}},"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/rightGroupMgmt/saveRightGroupBaseList":{"post":{"tags":["Permission Group Management"],"summary":"Save Permission Group","description":"## Function Description\n* Registers, modifies, and deletes permission group information.\n---\n## Detailed Description\n* Processes the registration, modification, and deletion information received all at once from the grid on the screen.\n* Required Value List\n * Permission Group No.\n * Permission Group Name\n * System Type Code\n * Application Start Date\n * Application End Date\n * Usage Status\n * Modifier ID\n","operationId":"saveRightGroupBaseList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestRightGroupBaseRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Dashboard Permission Group
> \## Function Description\
> \* Retrieves the dashboard permission group.\
> \---\
> \## Detailed Description\
> \* Retrieves permission information by permission target sequence number or call URL.\
> \* System type code is required.\
> \* Either the permission target sequence number or the call URL of the permission to retrieve is required.\
> \* When retrieving by call URL, returns the permission information matching the system type code.\
> \* The menuKey in the response parameter is composed of Permission Target Sequence No., '-', and Parent Permission Target Sequence No.
```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":{"StRtTgtBase":{"type":"object","description":"Authorization Target Basic Info","properties":{"rtTgtSeq":{"type":"string","description":"Authorization Target Sequence No."},"sysGbCd":{"type":"string","description":"System Classification Code (UR005)"},"rtTgtTypCd":{"type":"string","description":"Authorization Target Type Code (UR010)"},"rtTgtNm":{"type":"string","description":"Permission Target Name"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"callUrl":{"type":"string","description":"Call URL"},"useYn":{"type":"string","description":"Usage Status"},"custInfoInclYn":{"type":"string","description":"Include Customer Information Status"},"rmkCont":{"type":"string","description":"Remarks"},"popupYn":{"type":"string","description":"Popup Status"},"btnId":{"type":"string","description":"Button ID"},"uprRtTgtSeq":{"type":"string","description":"Parent Authorization Target Sequence No."},"leafMenuYn":{"type":"string","description":"Lowest-Level Menu Status"},"userHelpCont":{"type":"string","description":"User Help Content"}}},"DashBoardLinkResponse":{"type":"object","description":"Dashboard Permission Group Response DTO","properties":{"menuKey":{"type":"string","description":"Menu Key"},"rtTgtNm":{"type":"string","description":"Authorization Group Name"},"callUrl":{"type":"string","description":"Call URL"},"rtTgtSeq":{"type":"string","description":"Authorization Target Sequence No."}}},"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/rightGroupMgmt/getRtInfo":{"get":{"tags":["Permission Group Management"],"summary":"Retrieve Dashboard Permission Group","description":"## Function Description\n* Retrieves the dashboard permission group.\n---\n## Detailed Description\n* Retrieves permission information by permission target sequence number or call URL.\n* System type code is required.\n* Either the permission target sequence number or the call URL of the permission to retrieve is required.\n* When retrieving by call URL, returns the permission information matching the system type code.\n* The menuKey in the response parameter is composed of Permission Target Sequence No., '-', and Parent Permission Target Sequence No.\n","operationId":"getRtInfo","parameters":[{"name":"stRtTgtBase","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StRtTgtBase"}},{"name":"rtTgtSeq","in":"query","description":"Authorization Target Sequence No.","schema":{"type":"string"}},{"name":"callUrl","in":"query","description":"Call URL","schema":{"type":"string"}},{"name":"sysGbCd","in":"query","description":"System Classification Code","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DashBoardLinkResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Permission Group Button List
> \## Function Description\
> \* Retrieves the button list of a permission group menu on the screen.\
> \---\
> \## Detailed Description\
> \* Required Value List\
> \* Permission Target Sequence No.\
> \* System Type Code
```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":{"RightTargetBaseMenuRequest":{"type":"object","description":"Permission Group Button Request DTO","properties":{"rtGrpNo":{"type":"string","description":"Authorization Group No."},"rootRtGrpNo":{"type":"string","description":"Top-Level Authorization Group No."},"rtTgtSeq":{"type":"string","description":"Permission Target Sequence No."},"rtTgtTypCd":{"type":"string","description":"Authorization Target Type Code (UR010)"},"rtSubGbCd":{"type":"string","description":"Authorization Subject Type Code (UR006)"},"sysGbCd":{"type":"string","description":"System Classification Code (UR005)"},"useYn":{"type":"string","description":"Usage Status"},"uprRtTgtSeq":{"type":"string","description":"Parent Authorization Target Sequence No."}}},"RightTargetBaseMenuResponse":{"type":"object","description":"Permission Group Button List Response DTO","properties":{"rtGrpNo":{"type":"string","description":"Permission No."},"rtTgtSeq":{"type":"string","description":"Authorization Target Sequence No."},"rtTgtNm":{"type":"string","description":"Authorization Group Name"},"uprRtTgtSeq":{"type":"string","description":"Parent Authorization Target Sequence No."},"sysGbCd":{"type":"string","description":"System Type Code (UR005)"},"useYn":{"type":"string","description":"Usage Status"},"rtTgtTypCd":{"type":"string","description":"Authorization Target Type Code (UR010)"},"popupYn":{"type":"string","description":"Popup Status"},"level":{"type":"string","description":"Level"},"hierarchy":{"type":"string","description":"Variable for Tree Hierarchy"},"groupYn":{"type":"string","description":"Group Authorization Usage Status"},"rtSubGbCd":{"type":"string","description":"Permission Subject Type Code (UR006)"}}},"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/rightGroupMgmt/getRightGroupButtonList":{"get":{"tags":["Permission Group Management"],"summary":"Retrieve Permission Group Button List","description":"## Function Description\n* Retrieves the button list of a permission group menu on the screen.\n---\n## Detailed Description\n* Required Value List\n * Permission Target Sequence No.\n * System Type Code\n","operationId":"getRightGroupButtonList","parameters":[{"name":"stRtTgtMenuRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RightTargetBaseMenuRequest"}},{"name":"sysGbCd","in":"query","description":"System Classification Code","schema":{"type":"string"}},{"name":"rtTgtSeq","in":"query","description":"Authorization Target Sequence No.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RightTargetBaseMenuResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Permission Group List
> \## Function Description\
> \* Retrieves the permission group list according to the conditions selected on the screen.\
> \---\
> \## Detailed Description\
> \* Retrieves the permission group list according to the conditions selected on the screen.\
> \---\
> \## Revision History\
> \* Release v2.00\_241014 : Permission group list inquiry V2
```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":{"RightGroupBaseRequest":{"type":"object","properties":{"rtGrpNo":{"type":"string"},"sysGbCd":{"type":"string"},"rtGrpNm":{"type":"string"},"aplyStrDt":{"type":"string"},"aplyEndDt":{"type":"string"},"useYn":{"type":"string"}}},"RealGridListResponseRightGroupBaseResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/RightGroupBaseResponse"}}}},"RightGroupBaseResponse":{"type":"object","properties":{"rtGrpNo":{"type":"string"},"sysGbCd":{"type":"string"},"rtGrpNm":{"type":"string"},"aplyStrDt":{"type":"string"},"aplyEndDt":{"type":"string"},"useYn":{"type":"string"}}},"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/rightGroupMgmt/getRightGroupBaseList":{"get":{"tags":["Permission Group Management"],"summary":"Retrieve Permission Group List","description":"## Function Description\n* Retrieves the permission group list according to the conditions selected on the screen.\n---\n## Detailed Description\n* Retrieves the permission group list according to the conditions selected on the screen.\n---\n## Revision History\n* Release v2.00_241014 : Permission group list inquiry V2\n","operationId":"getRightGroupBaseList","parameters":[{"name":"rightGroupBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RightGroupBaseRequest"}},{"name":"sysGbCd","in":"query","description":"System Classification Code","schema":{"type":"string"}},{"name":"rtGrpNo","in":"query","description":"Authorization Group No.","schema":{"type":"string"}},{"name":"rtGrpNm","in":"query","description":"Authorization Group Name","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"Usage Status","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseRightGroupBaseResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Individual Permission Button List
> \## Function Description\
> \* Retrieves the button list of an individual permission menu on the screen.\
> \---\
> \## Detailed Description\
> \* Required Value List\
> \* Permission Target Sequence No.\
> \* System Type Code\
> \* Permission Group No.\
> \* Top-level Permission Group No.
```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":{"RightTargetBaseMenuRequest":{"type":"object","description":"Permission Group Button Request DTO","properties":{"rtGrpNo":{"type":"string","description":"Authorization Group No."},"rootRtGrpNo":{"type":"string","description":"Top-Level Authorization Group No."},"rtTgtSeq":{"type":"string","description":"Permission Target Sequence No."},"rtTgtTypCd":{"type":"string","description":"Authorization Target Type Code (UR010)"},"rtSubGbCd":{"type":"string","description":"Authorization Subject Type Code (UR006)"},"sysGbCd":{"type":"string","description":"System Classification Code (UR005)"},"useYn":{"type":"string","description":"Usage Status"},"uprRtTgtSeq":{"type":"string","description":"Parent Authorization Target Sequence No."}}},"RightTargetBaseMenuResponse":{"type":"object","description":"Permission Group Button List Response DTO","properties":{"rtGrpNo":{"type":"string","description":"Permission No."},"rtTgtSeq":{"type":"string","description":"Authorization Target Sequence No."},"rtTgtNm":{"type":"string","description":"Authorization Group Name"},"uprRtTgtSeq":{"type":"string","description":"Parent Authorization Target Sequence No."},"sysGbCd":{"type":"string","description":"System Type Code (UR005)"},"useYn":{"type":"string","description":"Usage Status"},"rtTgtTypCd":{"type":"string","description":"Authorization Target Type Code (UR010)"},"popupYn":{"type":"string","description":"Popup Status"},"level":{"type":"string","description":"Level"},"hierarchy":{"type":"string","description":"Variable for Tree Hierarchy"},"groupYn":{"type":"string","description":"Group Authorization Usage Status"},"rtSubGbCd":{"type":"string","description":"Permission Subject Type Code (UR006)"}}},"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/rightGroupMgmt/getIndivRightButtonList":{"get":{"tags":["Permission Group Management"],"summary":"Retrieve Individual Permission Button List","description":"## Function Description\n* Retrieves the button list of an individual permission menu on the screen.\n---\n## Detailed Description\n* Required Value List\n * Permission Target Sequence No.\n * System Type Code\n * Permission Group No.\n * Top-level Permission Group No.\n","operationId":"getIndivRightButtonList","parameters":[{"name":"stRtTgtMenuRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RightTargetBaseMenuRequest"}},{"name":"sysGbCd","in":"query","description":"System Classification Code","schema":{"type":"string"}},{"name":"rtTgtSeq","in":"query","description":"Authorization Target Sequence No.","schema":{"type":"string"}},{"name":"rtGrpNo","in":"query","description":"Authorization Group No.","schema":{"type":"string"}},{"name":"rootRtGrpNo","in":"query","description":"Top-Level Authorization Group No.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RightTargetBaseMenuResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```