Get role

GET

/system/roles/{ID}

curl --request GET \
  --url https://example.com/api/v1/system/roles/1 \
  --cookie grommunioAuthJwt=<grommunioAuthJwt>

• Default deployment path

Authorizations

• JWTCookie

Parameters

Path Parameters

ID

required

integer

ID of the object

Query Parameters

level

integer

Set detail level of return value. Usually ranges from 0 to 2.

Responses

200

List of roles returned

Media typeapplication/json

object

ID

Unique ID of the object

integer

name

string

<= 32 characters

description

string

nullable <= 256 characters

permissions

List of permissions associated with the role

Array<object>

object

ID

integer

permission

string

users

List of users associated with the role

Array<object>

object

ID

Unique ID of the object

integer

username

string

Example^generated

{
  "name": "example",
  "description": "example",
  "permissions": [
    {
      "ID": 1,
      "permission": "example"
    }
  ],
  "users": [
    {
      "username": "example"
    }
  ]
}

400

Validation of input parameters failed

Media typeapplication/json

object

message

string

errors

List of errors encountered during validation

Array<string>

Example^generated

{
  "message": "example",
  "errors": [
    "example"
  ]
}

404

The requested resource could not be found

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}

500

An error occurred while processing the request

Media typeapplication/json

object

message

String representation of the exception

string

Example^generated

{
  "message": "example"
}

503

The database query failed

Media typeapplication/json

object

message

Description of the error

string

Example^generated

{
  "message": "example"
}