Create an access role

Authorization

bearerAuth roles.manage

AuthorizationBearer <token>

Send Authorization: Bearer <credential>. Create API keys in AirTrail Security settings. OAuth clients use authorization code with PKCE S256 and a resource identifier matching /api/v1.

In: header

Scope: roles.manage

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Lengthlength <= 50

description?|

Lengthlength <= 200

permissions*array<string>

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/roles" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "permissions": [      "string"    ]  }'

{  "data": {    "id": "string"  }}

Create an access role

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

201application/json

401application/json

403application/json

Authorization

Request Body

Response Body

`application/json`

`application/json`

`application/json`