Security Roles

Retrieve a Security Role

Changed on

OAuth Scope

This endpoint requires the following OAuth scope read_security_roles.

get/securityrole/{uuid}.json

Request

  • Base URL
    https://api.servicem8.com/api_1.0
  • URL
    https://api.servicem8.com/api_1.0/securityrole/{uuid}.json
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.servicem8.com/oauth/authorize
      Token URL: https://api.servicem8.com/oauth/access_token scopes: read_security_roles

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-971c-409a-af66-23f944f46cab",
  "edit_date": "2026-03-01 12:00:00"
}

Changes

  • ca9b053c4373Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • e859f8c27a21Revision changes
    • info

      the security scope read_security_roles was added to the endpoint's security scheme oauth2