CAcautio
Gateway GRPC

Create a new role

post/v2/organisations/{organisation_id}/roles

Request

  • Base URL
    https://api.cautio.in (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

organisation_idstring required
Example:019aa01c-a1a9-7fae-961b-23845147892e

Organisation ID

Request body

namestring required

Name of the role

descriptionstring required

Description of the role

permission_idsstring[] required

List of permission ids

level0 | 1

Visibility level of the role

Example request

{
  "name": "Admin",
  "description": "Admin role",
  "permission_ids": [
    "a9a7e4e8-3e4b-4b1a-8e4a-4a2a4a2a4a2a"
  ],
  "level": 1
}

Response

successboolean required

Success status

messagestring required

Response Message

role_idstring

Newly created Role ID

Changes

No recorded changes to this operation across all 1 revision of this API.