Create role

POST

/v3/app/roles

创建角色
信息包含：角色名称、描述、权限信息

Request

Header Params

Body Params application/json

Examples

permissionScope=30 examplepermissionScope=0 example

{
    "name": "Test Role 1",
    "description": "Test create role",
    "hideAppForMembers": "false",
    "type": "0",
    "permissionScope": "30"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

permissionScope=30 examplepermissionScope=0 example

curl --location 'https://www.nocoly.com/v3/app/roles' \
--header 'HAP-Appkey;' \
--header 'HAP-Sign;' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Test Role 1",
    "description": "Test create role",
    "hideAppForMembers": "false",
    "type": "0",
    "permissionScope": "30"
}'

Responses

🟢200OK

application/json

Role created successfully

Bodyapplication/json

Example

{
    "data": {
        "id": "6825715d-92cc-4e15-83ce-8e39d1a667bc",
        "name": "New role 40",
        "roleType": 0,
        "desc": "",
        "users": [],
        "departments": [],
        "departmentTrees": [],
        "projectOrganizes": [],
        "jobs": []
    },
    "success": true
}

Modified at 2026-04-15 09:20:35

Get role list

Get role details