Sign in
Security Roles

Retrieve a Security Role

OAuth Scope

This endpoint requires the following OAuth scope read_security_roles.

get/securityrole/{uuid}.json

Path parameters

uuidstring uuid required

UUID of the Security Role

Response

Security Role record retrieved successfully

namestring required

The name given to the security role

role_descriptionstring

A detailed description of the security role's purpose and permissions. This field provides information about what access and capabilities are granted to users assigned this role.

uuidstring uuid

Unique identifier for this record

active0 | 1

Record active/deleted flag. Valid values are [0,1]

edit_datestring

Timestamp at which record was last modified

Example response

{
  "uuid": "123e4567-c794-4063-b0cb-2331200a996b",
  "edit_date": "2025-09-01 12:00:00"
}

Changes