Improve OpenAPI docs via `Path`/`Query` markers

[edan-bainglass]

We already use Query (check if consistently throughout).
We don't, however, mark path parameters (e.g., identifier) with Path(description=...).
Reminder to do so!