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

Werk #19537: Relay: Promote relay REST API endpoints to stable v1

Component REST API
Title Relay: Promote relay REST API endpoints to stable v1
Date Mar 20, 2026
Level Trivial Change
Class New Feature
Compatibility Compatible - no manual interaction needed
Checkmk versions & editions
2.6.0b1
Not yet released 		Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT

The relay REST API endpoints have been promoted from unstable to stable v1. The following endpoints are now available under /api/1.0/:

  • GET /domain-types/relay/collections/all — List all relays
  • GET /objects/relay/{relay_id} — Show a relay
  • PUT /objects/relay/{relay_id} — Edit a relay
  • DELETE /objects/relay/{relay_id} — Delete a relay
  • POST /domain-types/relay_registration_token/collections/all — Create a registration token

The create relay endpoint (POST /domain-types/relay/collections/all) has been moved to the internal API, as it is only used by the agent receiver during relay registration.

The previously used unstable paths will no longer work.

To the list of all Werks