DEV: Document the user suspend api endpoint (PR #12179)

Wrote an api docs rspec test for documenting the user suspend api endpoint.

GitHub