Document the pause and unpause commands available on API v1.12 onwards

There is some tooling documentation being written as #6601. This PR covers the API documentation.

(Replaces #6655 and includes DCO signature)