Skip to main content
POST
Create a custom role

Authorizations

Authorization
string
header
required

Plerion organization API key (plerion_oak_…), created by an organization admin in the Plerion app. GET operations work with a key of either access level; POST, PUT and DELETE require the readWrite access level.

Body

application/json
name
string
required
Required string length: 1 - 120
scope
enum<string>
required
Available options:
organization,
tenant
permissions
object[]
required
Minimum array length: 1

One permission: either actions or an actionGroup, optionally narrowed with resources. resources is * for every integration or a list of integration ids, and is required for actions whose resourceType is integration and not accepted otherwise.

description
string
Maximum string length: 500
tenantId
string<uuid>

Required for scope: tenant, not accepted for scope: organization.

Response

The created role.

data
object