Create a role

POST

https://example.itential.io/authorization/roles

Creates a role.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

request body

roleobjectOptional

This is the schema for an IAP role stored in Mongo

Result of role creation process

statusenum

The status of the API request.

messagestring

Message containing either confirmation of the operation or the reason for the failure of the operation.

dataobject

This is the schema for an IAP role stored in Mongo

500

Internal Server Error

$	curl -X POST https://example.itential.io/authorization/roles \
>	-H "Content-Type: application/json" \
>	-u "<username>:<password>" \
>	-d '{}'

1	{
2	"status": "OK",
3	"message": "A sample success message",
4	"data": {
5	"provenance": "Custom",
6	"name": "role_1",
7	"description": "description of role_1",
8	"allowedMethods": [
9	{
10	"name": "methodName",
11	"provenance": "ApplicationName"
12	}
13	],
14	"allowedViews": [
15	{
16	"path": "/manual/task/path",
17	"provenance": "ApplicationName"
18	}
19	],
20	"_meta": {
21	"created": "2018-08-02T15:56:12.912Z",
22	"updated": "2018-08-02T15:56:12.912Z"
23	}
24	}
25	}