The API doc is constantly being improved.
However, as the Breakcold team is shipping many features every month, there might be a delay between the new actions that you can do and what's in the API doc.
If something isn't clear, you can ask us in the live-chat.