Docs/make job api docs consistent

What does this MR do?

In !23538 (merged) when adding a new endpoint some docs inconsistencies were pointed out.

⚠ do not merge this before !23538 (merged) is merged since it consists code changes.

Author's checklist

• Apply the correct labels and milestone
• Crosslink the document from the higher-level index
• Crosslink the document from other subject-related docs
• Feature moving tiers? Make sure the change is also reflected in features.yml
• Correctly apply the product badges and tiers
• Port the MR to EE (or backport from CE): always recommended, required when the ee-compat-check job fails

Review checklist

• Your team's review (required)
• PM's review (recommended, but not a blocker)
• Technical writer's review (required)
• Merge the EE-MR first, CE-MR afterwards