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

Role name

permissionsobjectRequired

Access permissions

This endpoint returns an object.

idstring

UUID role ID

created_atdatetime

UTC datetime

updated_atdatetime

UTC datetime

namestring

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	}'