Create role

POST

/v3/app/roles

Create role
Information includes: role name, description, and permission information

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: {{appkey}}' \
--header 'HAP-Sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "test role 1",
    "description": "test create role",
    "hideAppForMembers": "false",
    "type": "0",
    "permissionScope": "30"
}'

Responses

🟢200Success

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-06-25 10:21:06

Get role list

Get role details