Roles

Create role

Changed on

Creates a new role scoped to the authenticated tenant.

Reserved role names (root, platform_admin, system, system_api) cannot be created through this endpoint — those are migration-managed.

post/api/roles

Request

  • Base URL: http://localhost:4100
  • URL: http://localhost:4100/api/roles
  • Auth: none required

Request body

descriptionstring required
metadataobject nullable
namestring required
tenant_idstring uuid required

Example request

{
  "description": "",
  "metadata": {},
  "name": "",
  "tenant_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6"
}

Changes