v1

latestOpenAPI 3.0.02026-07-24212113249.1 KB

Roles

Create a role

post/roles

Headers

organizationstring

The URL of the end-user web application

Request body

namestring required

Role name

descriptionstring required

Role description

publicboolean required

If True, this role is available to all user, including those that are not logged it.

defaultboolean required

If true, this user role is granted to any newly created organization.

permissionsstring[] required

An array of permission IDs

Example request

{
  "name": "DEFAULT-USER",
  "description": "This role allows user basic functionalities",
  "default": true,
  "permissions": [
    ""
  ]
}

Response

Role created

idstring required

Role ID

namestring required

Role name

descriptionstring required

Role description

publicboolean required

If True, this role is available to all user, including those that are not logged it.

defaultboolean required

If True, this role is assigned to any newly created organization.

Example response

{
  "permissions": [
    {
      "subject": {
        "id": "896632c05f1a59b6d395b963",
        "fields": [
          "name",
          "address"
        ],
        "entity": "accountstatuses"
      }
    }
  ],
  "name": "DEFAULT-USER",
  "description": "This role allows user basic functionalities",
  "default": true
}