Fix runner REST API documentation inconsistencies

What does this MR do and why?

This MR fixes inconsistencies in the Runner REST API documentation, when compared to the REST endpoint implementation and with the runner policy.

Changelog: fixed

References

Audit/fix documentation in `doc/api/runners.md` (#554850 - closed)

Screenshots or screen recordings

MR acceptance checklist

Evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.