The API docs are terrible

Feedback Documentation in English
1

Activate pending changes
https://checkmk.mysite.net/central/check_mk/api/doc/#operation/cmk.gui.plugins.openapi.endpoints.activate_changes.activate_changes
httpie example

sites:=‘[“production”]’\

Why the “:” ?

Show all pending changes
https://checkmk.mysite.net/central/check_mk/api/doc/#operation/cmk.gui.plugins.openapi.endpoints.activate_changes.list_pending_changes
httpie example

“Accept: application/json” \

Why the "" on the end?

not to mention the complete lack of Etag in Show all pending changes…

2

I don’t know what you have. This is exactly what you find inside the httpie documentation if raw data is sent.

For the “” around the header line, ok this is debatable.

But the title line has no connection to the content.

2 Likes