Wazuh icon

Wazuh

Work with the Wazuh Server API and Wazuh Indexer API

Actions15

Agent → Get

AI-generated

Summary

Retrieve details for a single Wazuh agent by its ID, optionally specifying which response fields to return.

Inputs

  • Agent ID (required) — ID of the Wazuh agent to retrieve.
  • Select — Comma-separated list of agent response fields to return (e.g., id,name,ip,status,version).

Output shape

a single record representing the requested agent's details, including optional metadata fields

Returns the first matching agent item under the main output. If the agent ID is not found, throws an error. The response includes additional metadata such as total items and messages.

Examples

Example 1: Get agent details for agent ID '001' including only id, name, and status fields.

Agent ID set to '001' and Select set to 'id,name,status'.

Links

Discussion