Create a role

POST

/roles

Create a new role from the specified values.

Auth

AuthorizationstringRequired

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

x-monite-versionstringRequired

x-monite-entity-idstringRequired

The ID of the entity that owns the requested resource.

This endpoint expects an object.

namestringRequired>=1 character<=255 characters

Role name

permissionsobjectRequired

Access permissions

Successful Response

idstring

UUID role ID

namestring>=1 character

Role name

permissionsobject

Access permissions

status"active" or "deleted"

Allowed values: activedeleted

record status, ‘active’ by default

created_atdatetime

UTC datetime

updated_atdatetime

UTC datetime

1	curl -X POST https://api.sandbox.monite.com/v1/roles \
2	-H "x-monite-version: 2023-09-01" \
3	-H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
4	-H "Authorization: Bearer <token>" \
5	-H "Content-Type: application/json" \
6	-d '{
7	"name": "name",
8	"permissions": {}
9	}'