Role Create

Create a new role in the system.

URL Requires Auth HTTP Method
/api/v1/roles.create yes POST


Argument Example Required Description
name newRole Required The name of the new role.
scope Subscriptions Optional
Default: Users
The scope of the new role.
description Role description Optional A description for the new role.

Example Call

curl -H "Content-type:application/json" \
     -H "X-Auth-Token: 9HqLlyZOugoStsXCUfD_0YdwnNnunAJF8V47U3QHXSq" \
     -H "X-User-Id: aobEdbYhXfu5hkeqG" \
     http://localhost:3000/api/v1/roles.create \
     -d '{ "name": "newRole" }' \
     -d '{ "scope": "Subscriptions" }' \
     -d '{ "description": "Role description" }' \

Example Result

    "role": {
        "_id": "newRole",
        "name": "newRole",
        "scope": "Subscriptions",
        "description": "Role description",
        "_updatedAt": "2018-08-23T03:57:54.603Z"
    "success": true

Change Log

Version Description
0.70.0 Added