Refresh API schema

[fbacall]

Summary of changes

• Document fields that were missing from API schemas
• Tighten up schemas (additionalProperties: false) to catch undocumented fields in tests
• Fix some legacy API inconsistencies

Motivation and context

API schemas were not up-to-date with current APIs

Checklist

• I have read and followed the CONTRIBUTING guide.
• I confirm that I have the authority necessary to make this contribution on behalf of its copyright owner and agree
  to license it to the TeSS codebase under the
  BSD license.