Create role

POST

/roles

Maintainer:Not configured

Creates a new role with the given name and permission set. Permission keys must be valid values from GET /roles/existing-permissions.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

API Key

Add parameter in header

x-tenant-id

Example:

x-tenant-id: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/roles' \
--header 'Authorization: Bearer <token>' \
--header 'x-tenant-id: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "permissions": {
        "property1": [
            "string"
        ],
        "property2": [
            "string"
        ]
    }
}'

Response Example

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "permissions": {
        "property1": [
            "string"
        ],
        "property2": [
            "string"
        ]
    },
    "userCount": 0
}

Modified at 2026-04-16 18:43:47

List roles

List all available permissions