Update namespaces.md

What does this MR do?

Update the documentation for the namespace api.

Are there points in the code the reviewer needs to double check?

No

Why was this MR needed?

The undocumented feature could be very useful for everyone.

Screenshots (if relevant)

none

Does this MR meet the acceptance criteria?

• [ - ] Changelog entry added, if necessary
• [ x ] Documentation created/updated
• API support added
• Tests added for this feature/bug
• Review
  • Has been reviewed by UX
  • Has been reviewed by Frontend
  • Has been reviewed by Backend
  • Has been reviewed by Database
• [ x ] Conform by the merge request performance guides
• [ x ] Conform by the style guides
• Squashed related commits together
• Internationalization required/considered
• End-to-end tests pass (package-qa manual pipeline job)

What are the relevant issue numbers?

#43200 (closed)