Method
POST

Request URL

/plugin/datafor-auth/api/roles/insert

Authorization
Authentication is required to use this API. The current user must have Administrator privileges.

Content Type
application/x-www-form-urlencoded

---

Preconditions

• The current user's user type must be "Administrator" to execute this API.

---

Description

This API creates a new user role with the specified authority level. Roles define user permissions and access control within the system.

---

Request Example

authority: DEV

Parameters Schema

Name	Location	Type	Required	Description
authority	body	string	Yes	The role name or authority level to be assigned.

---

Response Examples

Successful Response (HTTP 200)

{
  "success": true
}

Failure Response (Example)

{
  "msg": "Permission denied",
  "success": false
}

---

HTTP Responses

HTTP Status Code	Meaning	Description	Data Schema
200	OK	Request was successful	Inline

Response Data Schema (HTTP 200)

Name	Type	Required	Description
success	boolean	Yes	Indicates whether the role was successfully added.
msg	string	No	Response message (only present when the request fails).