Docs: Add an example for API joins with comments and host/services

fixes #10976

diff --git a/doc/9-icinga2-api.md b/doc/9-icinga2-api.md
index ee0e6f45ace2a7133b9d215667e3ea245027fd1c..42c9d3077c2d812e4a673337f89f5fd8ff1df249 100644 (file)
--- a/doc/9-icinga2-api.md
+++ b/doc/9-icinga2-api.md
@@ -501,6 +501,11 @@ via a join:
         ]
     }
 
+In case you want to fetch all [comments](6-object-types.md#objecttype-comment)
+for hosts and services, you can use the following query URL (similar example
+for downtimes):
+
+   https://localhost:5665/v1/objects/comments?joins=host&joins=service
 
 ### <a id="icinga2-api-config-objects-create"></a> Creating Config Objects