Pistis
API referencePeople and roles

Make a role

POST
/admin/api/roles

Needs People & roles. Of mcp.read and mcp.full a role keeps one (full wins). An unknown permission is refused.

Authorization

bearer
headerAuthorizationBearer <token>

An API token

Request Body

application/json
  1. body
name*string

1 to 40 characters, unique

permissions*array<string>

Response Body

Made

application/json
  1. response
id*string

admin and member are built in; others are made by an admin

name*string
builtIn*boolean
permissions*array<>
people*integer

How many people have it

Example Request
curl -X POST 'http://127.0.0.1:7777/admin/api/roles' \  -H 'Content-Type: application/json' \  -d '{  "name": "Auditor",  "permissions": [    "admin.usage",    "admin.audit"  ]}'
Example Response
{  "id": "string",  "name": "string",  "builtIn": true,  "permissions": [    "string"  ],  "people": 0}