Get a list of all Trusted Rules

Get trusted rules related to specific device names.

Resource name: /api/v1/trusted-rules/rules

Request Method: GET

Request parameters:

Parameter Type Description
deviceNames

mandatory

array of strings List of device tree names. Use the GET /devices method from the Devices Setup Resource Group to get device tree names.

cUrl Example: 

curl -X GET "https://localhost/api/v1/trusted-rules/rules?deviceNames=device1,device2" -H "Authorization: Bearer your-access-token"

Status codes:

Code Description
200 List of trusted rules
400 Validation error: Bad request due to invalid input
401 Unauthorized
403 Forbidden
404 Not Found
423 Locked
429 Too Many Requests
500 Internal Server Error
503 Service Unavailable

Response parameters:

Parameter Type Description
deviceName string Device tree name
deviceDisplayName string Human-readable name of the device
deviceId string Unique ID of the device within the system
trustedRules array List of trusted access rules associated with the device
ruleId string Unique identifier of the rule
source string Source object/group for the rule (e.g., network, zone, or host group)
destination string Destination object/group for the rule
service string Service/protocol allowed (e.g., ALL, HTTP, SSH)
comment string Free-text description or note about the rule
expirationDate string (date) Expiration date of the rule in YYYY-MM-DD format

Response example success 200:

Copy 
[
  {
    "deviceName": "s_10_30_25430_1",
    "deviceDisplayName": "s_10_30_254_30_1",
    "deviceId": "3",
    "trustedRules": [
      {
        "ruleId": "3",
        "source": "Office_All",
        "destination": "Bad_Hosts",
        "service": "ALL",
        "comment": "Adding Rule",
        "expirationDate": "2026-12-25"
      }
    ]
  }
]

Response example failure 400:

Copy 
{
  "error": "string",
  "description": "string",
  "fieldErrors": [
    {
      "field": "string",
      "error": "string"
    }
  ]
}