v1

latestOpenAPI 3.1.02026-07-2422707.0 MB

Retrieve the list of security roles in a center

This API helps you to fetch the list of security roles in a center.

You must specify appropriate details for the type parameter in the API request.

get/v1/organizations/security_roles?type={type}

Query parameters

type'' required

Mandatory Indicates that the list of security roles is to be retrieved from: All - 0, Organization - 1, Zone - 2, and Center - 3. Default value - 3. Note: Currently, this API only supports the retrieval of center-level security roles.

Response

200

{"stackTrail":"paths:/v1/organizations/security_roles?type={type}:get:responses:200:content:application/json:schema:properties:error","oasType":"schema","type":"unknown"}

Example response

{
  "security_roles": [
    {
      "id": "89736511-eb9d-437f-b6d0-91042cf7340b",
      "name": "Accountant"
    }
  ],
  "page_info": {
    "total": 12,
    "page": 1,
    "size": 12
  }
}