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

Role name

permissionsobjectRequired

Access permissions

Successful Response

idstring

UUID role ID

created_atdatetime

UTC datetime

updated_atdatetime

UTC datetime

namestring=1 character

Role name

permissionsobject

Access permissions

status"active" or "deleted"

Allowed values: activedeleted

record status, ‘active’ by default

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