Update a role | Itential

Updates a role.

AuthorizationBasic

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

roleIdstringRequired

The individual role to update.

request body

updatesobjectOptional

The output of the role update.

statusenum

The status of the API request.

Allowed values:

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 PATCH http://localhost:3000/authorization/roles/roleId \
>	-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	}

$	curl -X PATCH http://localhost:3000/authorization/roles/roleId \
>	-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	}