Updated descriptions

[Shushishtok]

• Updated description of most API calls to more correctly reflect requirements and results.
• Updated the types of some API calls headers and bodies.
• Gave descriptions to ALL fields in every type.
• Some symbol types were added to enforce enums.
• Added default values to pagination headers.

[eseidel]

This causes the Dart openapi generator to barf. The previous commit 6ee89f81cb876f05ffd94632a92e4fd8b92ced20 does not. 🤷

openapi.log

[space-admiral]

Thanks for the ping! I think we tracked it down and pushed the fix. Let me know if you still have issues.