Create a role

Creates a new role with the provided details.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
allowedDurations
array of objects | null

Allowed durations (in seconds) for access requests to this role. If omitted or set to null, inherits from the parent resource's allowed durations, which in turn may inherit from the integration. Empty array is not allowed. Values must be from the predefined enum.

allowedDurations
boolean
required

Indicates if the role is requestable

workflow
object | null

Workflow associated with the role (object with 'id' UUID). To get available workflow IDs, use GET /public/v1/workflows. If null, inherits from the parent resource's workflow.

prerequisitePermissions
array of arrays of objects
required

Prerequisite permissions grouped by any-of/all-of sets. Outer array represents OR logic (any set can match), inner arrays represent AND logic (all permissions in a set must match). To get role permission IDs, use GET /public/v1/roles?resourceId=.

prerequisitePermissions*
resource
object
required

Resource to attach this role to (object with 'id' UUID). To get resource IDs, use GET /public/v1/resources?integrationId=.

virtualizedRole
object

Virtualized role to link to this resource role (object with 'id' UUID). To get virtualized role IDs, first create a 'Virtual Application' integration with resources and roles, then use GET /public/v1/roles?resourceId= where the resource belongs to that virtual integration.

string
required
length between 2 and 50

Display name for the role

Response

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

©2003-2026 BeyondTrust Corporation. All Rights Reserved. Other trademarks identified on this page are owned by their respective owners. BeyondTrust is not a chartered bank or trust company, or depository institution. It is not authorized to accept deposits or trust accounts and is not licensed or regulated by any state or federal banking authority.