Skip to main content
POST
/
rbac
/
roles
Error
A valid request URL is required to generate request examples
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "is_system": true,
  "slug": "<string>",
  "description": "<string>",
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "scopes": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "resource": "<string>",
      "action": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "source_ref": "<string>",
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}
{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}

Authorizations

fastapiusersauth
string
cookie
required

Body

application/json

Create schema for a custom role.

name
string
required

Role name

Required string length: 1 - 128
description
string | null

Optional description of the role

Maximum string length: 512
scope_ids
string<uuid>[]

List of scope IDs to assign to the role

Response

Successful Response

Read schema for a role with its scopes.

id
string<uuid>
required
name
string
required
organization_id
string<uuid>
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
is_system
boolean
required
read-only

Whether this is a preset system role.

slug
string | null
description
string | null
created_by
string<uuid> | null
scopes
ScopeRead · object[]