Zorus icon

Zorus

Interact with the Zorus API to manage customers, endpoints, groups, policies, deployment tokens, and unblock requests

Endpoints → Post Api Endpoints Search

AI-generated

Summary

Search endpoints in the Zorus system using optional filters, pagination, and sorting options.

Inputs

  • Zorus Api Version (required) — The API version to use for the request (sent as header 'Zorus-Api-Version').
  • Additional Body Fields — Optional search, pagination, and sorting filters to refine the endpoint search results. These include parameters like page number, page size, sort property (currently only 'Name'), sort ascending flag, filters by name substring, enabled status, UUID equality or inclusion in a set, license ID, customer UUID, group UUID, error state, agent state, last seen dates, group settings inheritance, filtering enabled, and CyberSight enabled flags.

Output shape

a list of endpoint records

The operation returns an array of endpoint objects matching the supplied filters. Each endpoint object may include properties such as customer and group information, UUIDs, names, policy UUID, license ID, creation date, status flags (enabled, error state, filtering enabled, CyberSight enabled), operating system details, IP address, version, browser extension state, agent state, and last seen date. Pagination and sorting control the subset and order of returned endpoints.

Examples

Example 1: Search endpoints filtering by name substring and enabled status

Set 'nameContains' to a string value and 'isEnabled' to true or false in Additional Body Fields, specify page and pageSize if needed to control pagination.

Example 2: Retrieve all endpoints sorted by name ascending

Set 'sortProperty' to 'Name', 'sortAscending' to true, and optionally define 'page' and 'pageSize' for pagination.

Links

Discussion