Create Role

This endpoint creates a new Role.

Request

To create a new Role please make a POST request to the following URL:

HTTP MethodURL
POSThttps://industrial.api.ubidots.com/api/v2.0/roles/

Query Parameters

ParameterTypeUseDescription
tokenStringAuthenticationAuthorization Token can optionally be sent as a query parameter.

Body Parameter

ParameterTypeRequired?Default Value
labelStringNorole name
nameStringYesN/A (Required)
descriptionStringNo""
permissionsListsYesN/A (Required)

Header

ParameterRequired?Description
X-Auth-TokenYesAuthentication Token of account
Content-TypeYesContent type of body: String (application/json)
$ curl -X POST 'https://industrial.api.ubidots.com/api/v2.0/roles/' \ -H 'Content-Type: application/json' \ -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \ -d '{ "name": "Dashboards Viewer Clone", "permissions": [ { "label": "view_dashboard", "name": "Permission to view a Dashboard.", "model": "dashboard" }, { "label": "view_widget", "name": "Permission to view a Widget.", "model": "dashboard" }, ] }'
{ "url": "https://industrial.api.ubidots.com/api/v2.0/roles/dashboards-viewer-clone", "label": "dashboards-viewer-clone", "name": "Dashboards Viewer Clone", "description": "", "permissions": [ { "label": "view_dashboard", "name": "Permission to view a Dashboard.", "model": "dashboard" }, { "label": "view_widget", "name": "Permission to view a Widget.", "model": "dashboard" }, ], "createdAt": "2023-03-07T13:58:18.605688Z", "isActive": true, "permissionsCount": 2 }
{ "code": 400001, "message": "Validation Error.", "detail": { .... } }
{ "code": 401001, "message": "Authentication credentials were not provided.", "detail": "Authentication credentials were not provided." }

Response

Returns a Role Object of the Role created.