feat: API specs update for version latest#77
Conversation
Greptile SummaryThis automated spec update adds
Confidence Score: 3/5Safe to merge only after reverting the object-typed fields whose defaults were changed from {} to [] in the three OpenAPI 3 spec files. The three OpenAPI 3 files (client, console, server) all contain multiple object-typed request-body fields — document data, function execution headers, screenshot headers, presence metadata — whose defaults were silently changed from {} to []. Any SDK generator consuming these specs will emit empty-array defaults for those parameters instead of empty-object defaults, producing runtime type errors for consumers of the generated SDKs. open-api3-latest-server.json, open-api3-latest-console.json, and open-api3-latest-client.json — specifically all object-typed fields that now carry "default": []. Important Files Changed
Reviews (1): Last reviewed commit: "chore: update API specs with OpenAPI 3 p..." | Re-trigger Greptile |
| "type": "object", | ||
| "x-example": "{\"Authorization\":\"Bearer token123\",\"X-Custom-Header\":\"value\"}", | ||
| "default": {} | ||
| "default": [], | ||
| "x-example": "{\"Authorization\":\"Bearer token123\",\"X-Custom-Header\":\"value\"}" |
There was a problem hiding this comment.
Type mismatch: object-typed field defaulting to array
"type": "object" fields in the OpenAPI 3 specs have had their defaults changed from {} to [] across this PR. [] is a JSON array, not a valid default for an object schema — this violates OpenAPI 3.0 spec validation and will cause code generators and SDK generators to emit incorrect default values (empty arrays instead of empty objects). Affected fields include the screenshot headers parameter (here), multiple database data fields (e.g. lines ~14707, ~14943, ~15317), the function execution headers field, and the presence metadata field. The same pattern repeats in open-api3-latest-console.json and open-api3-latest-client.json. All should revert to "default": {}.
This PR contains API specification updates for version latest.