- Development Integration
- /
- SDK
- /
- Python
- /
Management Module
- /
Role Management
- /
- Get Role Department List
¶ Get the department list of the role
Update time: 2025-07-23 07:34:21
This document is automatically generated based on https://github.com/authing/authing-docs-factory based on the https://api-explorer.genauth.ai V3 API, and is consistent with the API parameters and return results. If the description of this document is incorrect, please refer to the V3 API.
Get the department list of the role through the role code in the permission group, supporting paging.
¶ Method name
ManagementClient.list_role_departments
¶ Request parameters
| Name | Type | Required | Default value | Description | Sample value |
|---|---|---|---|---|---|
| code | string | yes | - | Unique identifier of the role in the permission group | manager |
| namespace | string | no | - | Code of the permission group | default |
| page | number | no | 1 | Current page number, starting from 1 | 1 |
| limit | number | no | 10 | Number of pages per page, maximum cannot exceed 50, default is 10 | 10 |
¶ Request Response
Type: RoleDepartmentListPaginatedRespDto
| Name | Type | Description |
|---|---|---|
| statusCode | number | Business status code, which can be used to determine whether the operation is successful. 200 means success. |
| message | string | Description |
| apiCode | number | Segmented error code, which can be used to get the specific error type (successful request does not return). For a detailed list of error codes, see: API Code List (opens new window) |
| requestId | string | Request ID. Returned when the request fails. |
| data | RoleDepartmentListPagingDto | Data |
Example results:
{
"statusCode": 200,
"message": "Success",
"requestId": "934108e5-9fbf-4d24-8da1-c330328abd6c",
"data": {
"list": {
"id": "60b49eb83fd80adb96f26e68",
"code": "code",
"name": "departmentName",
"description": "dd8d7stf44"
}
}
}
¶ Data Structure
¶ RoleDepartmentListPagingDto
| Name | Type | Required | Description | Sample value |
|---|---|---|---|---|
| totalCount | number | Yes | Total number of records | |
| list | array | Yes | Data Nested type: RoleDepartmentRespDto. |
¶ RoleDepartmentRespDto
| Name | Type | Required | Description | Sample value |
|---|---|---|---|---|
| id | string | Yes | Department ID | 60b49eb83fd80adb96f26e68 |
| code | string | Yes | Department code | code |
| name | string | Yes | Department name | departmentName |
| description | string | Yes | Department description | dd8d7stf44 |