Create Role

POST

https://Example-Server.com/be/v1/roles

Last modified:2026-01-26 14:38:18

This endpoint creates a role in your ROCKIT Edge Organization.

Required Permissions

roles.create

See Roles for more details.

Request

Header Params

Body Params application/json

Example

{
    "name": "exampleName",
    "apps": 1,
    "beUsers": 15,
    "bundles": 6,
    "consumption": 1,
    "dependencies": 12,
    "deployments": 3,
    "keys": 11,
    "roles": 15,
    "sources": 12,
    "subscriptions": 12,
    "tasks": 20,
    "trainings": 2
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://Example-Server.com/be/v1/roles' \
--header 'x-rockit-beauth-token: {{_edge_org_admin_beauth_token}}' \
--header 'x-rockit-orgname: ExampleOrg' \
--header 'x-rockit-username: adminPrincipal' \
--header 'x-rockit-api-key: {{_adminPrincipal_apiKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "exampleName",
    "apps": 1,
    "beUsers": 15,
    "bundles": 6,
    "consumption": 1,
    "dependencies": 12,
    "deployments": 3,
    "keys": 11,
    "roles": 15,
    "sources": 12,
    "subscriptions": 12,
    "tasks": 20,
    "trainings": 2
}'

Responses

🟢200200: success

application/json

Body

Example

{"status":"success","message":"role created"}

🟠400400: missing-param

🟠401401: token-expired

🟠409409: item-exists

Modified at 2026-01-26 14:38:18

List Roles

Patch Role

Create Role

Required Permissions#

Request

Request Code Samples

Responses

Required Permissions