Wrong syntax in Zoom-API's json schema files

API and Webhooks
1

Affected API Endpoint(s)

Zoom Phone APIs, operation id “phoneUserSettings” and others

[zoom]/docs/api/phone/#tag/users/get/phone/users/{userId}/settings

Description
When using openapi-tools to generate a JAVA client using Zoom’s Phone API json schema file, three syntax errors occur.

Error?
- in operation ““/phone/users/{userId}/settings” (id: phoneUserSettings), reponses→200→content→delegation→privileges→items there the syntax error occurs: within, the “enum” attribute is misplaced - it should be within “items”, not below as a sibling attribute.

Same syntax error takes place at two other locations, all sharing the hint, being an enum property of a model where items has got an examples attribute

How To Reproduce
Steps to reproduce the behavior:
1. feed openapi-tools-java with the Phone.json file from Zoom’s developer website/download

2. see syntax errors:

[ERROR] […]/zoom/phone/client/models/AddUserSetting201ResponseDelegation.java:[52,5] enum constant expected here
[ERROR] […]/zoom/phone/client/models/PhoneUserSettings200ResponseDelegation.java:[53,5] enum constant expected here
[ERROR] […]/zoom/phone/client/models/UpdateUserSettingRequestDelegation.java:[48,5] enum constant expected here

2

Hi @Thomas7
Thanks for bringing this up to our attention.
I reviewed the specs and identified the issue you mentioned. I reached out to our Engineering team and reported this, I will update you as soon as I hear back from them ( Internal ticket number for reference ZSEE-176583)