Skip to main content
POST
Create custom role
Creates a new custom role within your tenant. Custom roles let you define access permissions tailored to your team structure. After creating a role, assign it to users with the assign role endpoint. See RBAC & permissions for the full list of available permissions and guidance on role design.

Responses

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
name
string
required

Descriptive role name (e.g. attestation_minter, compliance_officer).

description
string

Brief explanation of the role purpose.

Response

Custom role created.

id
string<uuid>
tenant_id
string<uuid>
name
string
description
string
is_system
boolean
created_at
string<date-time>
updated_at
string<date-time>