Update a role | Monite Documentation

Change the specified fields with the provided values.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

role_idstringRequired

This endpoint expects an object.

namestringOptional1-255 characters

The new name for this role. Role names are case-sensitive, can contain only ASCII characters, and must be unique.

permissionsobjectOptional

Access permissions

Successful Response

idstringformat: "uuid"

UUID role ID

created_atdatetime

UTC datetime

updated_atdatetime

UTC datetime

namestring>=1 character

Role name

permissionsobject

Access permissions

statusenum

record status, 'active' by default

Allowed values:

400

Patch Roles ID Request Bad Request Error

401

Patch Roles ID Request Unauthorized Error

404

Patch Roles ID Request Not Found Error

422

Patch Roles ID Request Unprocessable Entity Error

429

Patch Roles ID Request Too Many Requests Error

1	curl -X PATCH https://api.sandbox.monite.com/v1/roles/role_id \
2	-H "x-monite-version: 2024-05-25" \
3	-H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
4	-H "Authorization: Bearer <token>" \
5	-H "Content-Type: application/json" \
6	-d '{}'

1	{
2	"id": "id",
3	"created_at": "2024-01-15T09:30:00Z",
4	"updated_at": "2024-01-15T09:30:00Z",
5	"name": "name",
6	"permissions": {
7	"objects": [
8	{
9	"object_type": "accounting_tax_rate",
10	"actions": [
11	{
12	"action_name": "create",
13	"permission": "allowed"
14	}
15	]
16	}
17	]
18	},
19	"status": "active"
20	}