Application API
  1. role
Application API
  • V3 (AI-friendly-beta)
    • Overview
    • Field Type Comparison Table
    • Guidelines for Using Filters
    • Error Code
    • application
      • Get application information
    • worksheet
      • Get worksheet structure information
      • Edit the worksheet
      • Delete worksheets
      • Create worksheet
    • worksheet Row Records
      • Get a list of line records
      • Get line record details
      • Update line records
      • Delete line records
      • Get relation records
      • Create a new row record
      • Add new line records in batches
      • Batch update line records
      • Batch delete row records
      • Obtain line record perspective data
      • Get record sharing links
      • Get a row record log
      • Get line record discussion
    • option set
      • Get a list of option sets
      • Create an option set
      • Edit option set
      • Delete option set
    • workflow
      • Get a list of processes
      • Get process details
      • Trigger process
    • role
      • Get a list of roles
        GET
      • create role
        POST
      • Get role details
        GET
      • remove roles
        DELETE
      • Add role members
        POST
      • Remove role members
        DELETE
      • Members withdraw from all roles
        DELETE
    • public query
      • find members
      • Find departments
      • Get regional information
  • V2
    • Development Guide
    • ErrorCode
    • Filter Demo
    • Filter
    • Options Set
      • Add Option Set
      • Get Option Set
      • Edit Option Set
      • Delete Option Set
    • Application Role
      • Get Application Role List GET
      • Create Application Role
      • Delete Application Role
      • Add Application Role Member
      • Remove Application Role Member
      • Exit application
      • Get Role Details
    • worksheet
      • Create Worksheet
      • Get worksheet structure information
      • Get List
      • Create Row Record
      • Batch Create Row Records
      • Get Row Record Details
      • Get row record details
      • Update Row Record Details
      • Batch Update Row Record Details
      • Delete Row Record
      • Get associated record
      • Get Record Share Link
      • Get total row count of worksheet
      • Get Row Record Log
    • app
      • Get Application Information
    • Public Inquiries
      • Get regional Information
    • Get Row Record Discussions
      POST
  1. role

create role

Testing
fromal
https://api.mingdao.com
fromal
https://api.mingdao.com
POST
/v3/app/roles
create role
Information includes: role name, description, and authority information

Request

Header Params

Body Params application/json

Example
{
    "name": "string",
    "description": "string",
    "permissionScope": 100,
    "type": 0,
    "hideAppForMembers": true,
    "globalPermissions": {
        "addRecord": true,
        "share": true,
        "import": true,
        "export": true,
        "discuss": true,
        "systemPrint": true,
        "attachmentDownload": true,
        "log": true
    },
    "worksheetPermissions": [
        {
            "id": "string",
            "recordPermissionInViews": [
                {
                    "viewId": "string",
                    "read": true,
                    "edit": true,
                    "delete": true
                }
            ],
            "recordDataScope": {
                "read": 0,
                "edit": 0,
                "delete": 0
            },
            "worksheetActions": {
                "shareView": true,
                "import": true,
                "export": true,
                "discuss": true,
                "batchOperation": true
            },
            "recordActions": {
                "add": true,
                "share": true,
                "discuss": true,
                "systemPrint": true,
                "attachmentDownload": true,
                "log": true
            },
            "paymentActions": {
                "pay": "string"
            },
            "fieldPermissions": [
                {
                    "id": "string",
                    "add": true,
                    "read": true,
                    "edit": true,
                    "decrypt": true
                }
            ]
        }
    ],
    "pagePermissions": [
        {
            "id": "string",
            "enable": true
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mingdao.com/v3/app/roles' \
--header 'HAP-Appkey: {{appkey}}' \
--header 'HAP-Sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "description": "string",
    "permissionScope": 100,
    "type": 0,
    "hideAppForMembers": true,
    "globalPermissions": {
        "addRecord": true,
        "share": true,
        "import": true,
        "export": true,
        "discuss": true,
        "systemPrint": true,
        "attachmentDownload": true,
        "log": true
    },
    "worksheetPermissions": [
        {
            "id": "string",
            "recordPermissionInViews": [
                {
                    "viewId": "string",
                    "read": true,
                    "edit": true,
                    "delete": true
                }
            ],
            "recordDataScope": {
                "read": 0,
                "edit": 0,
                "delete": 0
            },
            "worksheetActions": {
                "shareView": true,
                "import": true,
                "export": true,
                "discuss": true,
                "batchOperation": true
            },
            "recordActions": {
                "add": true,
                "share": true,
                "discuss": true,
                "systemPrint": true,
                "attachmentDownload": true,
                "log": true
            },
            "paymentActions": {
                "pay": "string"
            },
            "fieldPermissions": [
                {
                    "id": "string",
                    "add": true,
                    "read": true,
                    "edit": true,
                    "decrypt": true
                }
            ]
        }
    ],
    "pagePermissions": [
        {
            "id": "string",
            "enable": true
        }
    ]
}'

Responses

🟢200OK
application/json
Body

Example
{
    "data": {
        "id": "6825715d-92cc-4e15-83ce-8e39d1a667bc",
        "name": "New role 40",
        "roleType": 0,
        "desc": "",
        "users": [],
        "departments": [],
        "departmentTrees": [],
        "projectOrganizes": [],
        "jobs": []
    },
    "success": true
}
Modified at 2025-08-21 09:35:00
Previous
Get a list of roles
Next
Get role details
Built with