action truesight_search_devices { label: "Searches devices by name, model, manufacturer or serial number." description: "Gets the DeviceSummary instances whose name, model, manufacturer or serial number match the specified criteria.

If a parent ID (group ID, application ID, or service ID) is provided, the function narrows down the devices list to those attached to the specified parent:
- use the hardware/groups service in the Groups section to get all available group IDs.
- use the hardware/applications service in the Applications section to get all available application IDs.
- use the hardware/services service in the Services section to get all available service IDs.

Note: At most, one parent ID is taken into account according to this order of precedence:
  1. group ID
  2. application ID
  3. service ID
" provider: truesight method: GET path: "/hardware/search-devices" encoding: json input: { type: "object" properties: { applicationId: { type: "string" } groupId: { type: "string" } limit: { type: "integer" format: "int32" } page: { type: "string" format: "int32" } searchTerms: { type: "string" } serviceId: { type: "string" } } required: ["searchTerms"] additionalProperties: false } output: { type: "object" additionalProperties: true } }