apidoc - Permit the use of multiple examples

Some documentation route mentions multiple routes which do not take the same number of parameters. Yet, they do not necessarily need another documentation endpoint. Ideally, we should be able to present multiple examples to clarify how the api endpoints can be used.

---

Migrated from T628 (view on Phabricator)