Explore the latest product updates and best practices at our hybrid Checkmk Conference #12 from June 16-18, 2026 – Register here

Werk #13399: RESTAPI: Endpoint for downloading agent by host name

Component REST API
Title RESTAPI: Endpoint for downloading agent by host name
Date Oct 28, 2021
Level Trivial Change
Class New Feature
Compatibility Incompatible - Manual interaction might be required
Checkmk versions & editions
2.1.0b1 Checkmk Community, Checkmk Pro, Checkmk Ultimate MT
2.0.0p18 Checkmk Community, Checkmk Pro, Checkmk Ultimate MT

Agent can now be downloaded by operating system and host name:

/check_mk/api/1.0/domain-types/agent/actions/download_by_host/invoke?os_type=linux_tgz&host_name=example.com

The previous URL used to download agents via the agent hash:

/check_mk/api/1.0/objects/agent_binary/80e99ba3a66d4880?os_type=linux_tgz

is replaced by

/check_mk/api/1.0/domain-types/agent/actions/download_by_hash/invoke?os_type=linux_tgz&agent_hash=80e99ba3a66d4880

In checkmk raw edition the packaged agents can now be downloaded by the following URL:

/check_mk/api/1.0/domain-types/agent/actions/download/invoke?os_type=linux_deb

Full description can be found in the built in REST API Documentation.

To the list of all Werks