Sign in

v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-15367117899.6 KB
Roles

Create a custom role

Create a custom role in Betayum. Create custom roles and resolve permission sets for organization-level access control.

post/v1/roles

Request body

namestring required

Name of the custom role

permissionsobject required

Permissions for the role. Keys are resource names, values are arrays of allowed actions.

obligationsobject

Obligations for the role. Boolean flags for requirements like compliance.

Example request

{
  "name": "Compliance Lead",
  "permissions": {
    "control": [
      "read",
      "update"
    ],
    "policy": [
      "read",
      "update"
    ],
    "risk": [
      "read"
    ]
  },
  "obligations": {
    "compliance": true
  }
}

Response

Role created successfully

idstring
namestring
permissionsobject
isBuiltInboolean
createdAtstring date-time
updatedAtstring date-time

Example response

{
  "id": "rol_abc123",
  "name": "compliance-lead"
}