Skip to content

feat: API specs update for version latest - #96

Merged
ChiragAgg5k merged 2 commits into
mainfrom
feat-latest-specs
Aug 19, 2026
Merged

feat: API specs update for version latest#96
ChiragAgg5k merged 2 commits into
mainfrom
feat-latest-specs

Conversation

@ChiragAgg5k

Copy link
Copy Markdown
Member

What does this PR do?

Regenerates the latest client, server, and console OpenAPI specs with official schema fields:

  • nullable replaces x-nullable
  • example replaces x-example
  • array, object, numeric, and boolean examples use native JSON values
  • absent examples are omitted instead of emitted as null

JSON response properties declared as arrays now emit array schemas with object items. This includes migration report data and Cloud JSON-array models such as WAF conditions, dedicated database rows, plan estimation entries, and app installation authorization details.

Generated from appwrite-labs/cloud#5374. This PR remains a draft until appwrite/appwrite#13279 is merged and the Cloud lock is refreshed, after which the workflow output will be verified against this branch.

Validation

  • Zero x-example occurrences
  • Zero x-nullable occurrences
  • Zero example: null values
  • Every schema example matches its declared type, including nested array items
  • Swagger Validator: zero errors and warnings for client, server, and console
  • Byte-identical platform specs to the corresponding 1.9.x regeneration

@ChiragAgg5k
ChiragAgg5k marked this pull request as ready for review August 19, 2026 09:39
@greptile-apps

greptile-apps Bot commented Aug 19, 2026

Copy link
Copy Markdown

Greptile Summary

Regenerates the latest client, console, and server OpenAPI specifications to use standard OpenAPI schema fields and correctly typed examples.

  • Replaces x-example and x-nullable with example and nullable.
  • Converts serialized examples to native JSON values and omits absent examples.
  • Corrects JSON-array response schemas and preserves empty-array examples.

Confidence Score: 5/5

The PR appears safe to merge because no concrete changed-code failure was identified.

The regenerated specifications consistently adopt standard OpenAPI metadata and native example types, and the investigated schema changes did not establish a reachable validation, generation, or runtime failure.

Important Files Changed

Filename Overview
specs/latest/open-api3-latest-client.json Updates client-facing schema metadata and examples to standard OpenAPI fields and native JSON types; no changed-code defect was established.
specs/latest/open-api3-latest-console.json Regenerates console schemas, including corrected array models and examples; no changed-code defect was established.
specs/latest/open-api3-latest-server.json Regenerates server schemas with standard nullable/example fields and corrected JSON-array definitions; no changed-code defect was established.

Reviews (1): Last reviewed commit: "fix: preserve empty array examples" | Re-trigger Greptile

@ChiragAgg5k
ChiragAgg5k merged commit 4095f6c into main Aug 19, 2026
2 checks passed
@ChiragAgg5k
ChiragAgg5k deleted the feat-latest-specs branch August 19, 2026 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant