Get a list of roles

Testing

fromal

https://api.mingdao.com

GET

/v3/app/roles

Get a list of roles under the application

Request

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.mingdao.com/v3/app/roles' \
--header 'HAP-Appkey: {{appkey}}' \
--header 'HAP-Sign: {{sign}}'

Responses

🟢200OK

application/json

Body

Example

{
    "data": {
        "roles": [
            {
                "id": "role Id",
                "name": "role name",
                "roleType": "role type",
                "desc": "role description",
                "accounts": [
                    {
                        "id": "account ID",
                        "name": "user name",
                        "avatar": "User avatar link"
                    }
                ],
                "departmentTrees": [
                    {
                        "id": "Department ID",
                        "name": "Department Name"
                    }
                ],
                "departments": [
                    {
                        "id": "Department ID",
                        "name": "Department Name"
                    }
                ],
                "jobs": [
                    {
                        "id": "position ID",
                        "name": "job title"
                    }
                ],
                "orgRoleIds": [
                    "Organization Role ID"
                ]
            }
        ]
    },
    "success": true
}

Modified at 2025-08-21 09:35:00

Trigger process

create role