Improve the MR documentation

What does this MR do?

This brings the MR documentation up-to-date with the reality. I discovered the discrepancy while tryout the API, and looking at the documentation at the same time.

Does this MR meet the acceptance criteria?

• [-] Changelog entry added, if necessary
• Documentation created/updated
• [-] Tests added for this feature/bug
• Conforms to the code review guidelines
• Conforms to the merge request performance guidelines
• Conforms to the style guides
• Conforms to the database guides