Improve REST OpenAPI documentation for auth

[kennyadsl]

Summary

This change will show the correct format of the api key token in the generated documentation.

Before

After

Checklist

Check out our PR guidelines for more details.

The following are mandatory for all PRs:

• I have written a thorough PR description.
• I have kept my commits small and atomic.
• I have used clear, explanatory commit messages.

The following are not always needed:

• 📖 I have updated the README to account for my changes.
• 📑 I have documented new code with YARD.
• 🛣️ I have opened a PR to update the guides.
• ✅ I have added automated tests to cover my changes.
• 📸 I have attached screenshots to demo visual changes.

[kennyadsl]

Pushed a new commit to mark another spec as flaky, due to this failure.

[codecov]

Codecov Report

Merging #4951 (6b1fff0) into master (0c52edf) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #4951   +/-   ##
=======================================
  Coverage   86.69%   86.69%           
=======================================
  Files         578      578           
  Lines       14681    14681           
=======================================
  Hits        12728    12728           
  Misses       1953     1953           

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more