Skip to content

feat: API specs update for version 2.3.x - #119

Merged
ChiragAgg5k merged 2 commits into
mainfrom
feat-2.3.x-specs
Sep 23, 2026
Merged

ChiragAgg5k merged 2 commits into
mainfrom
feat-2.3.x-specs

Conversation

@appwrite-specifications

Copy link
Copy Markdown
Contributor

This PR contains API specification updates for version 2.3.x.

@greptile-apps

greptile-apps Bot commented Sep 23, 2026 •

Copy link
Copy Markdown

RetriggerConfidence Score: 4/5

The PR is not ready to merge because hundreds of newly published Java examples fail to compile as written.

Fix All in Claude CodeFindings

  1. P1 Missing Java Collection Imports ▶
Fix with agent prompt
### Issue 1
examples/2.3.x/client-android/java/account/create-o-auth-2-session.md:19
This snippet calls `List.of()` but does not import `java.util.List`, so copying it into a Java or Android project fails to compile with an unresolved symbol. The same generator issue affects 266 new Java examples, including examples that use `Map.of()` without importing `java.util.Map`; please update the generator templates to emit the required imports.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

This PR publishes the Appwrite 2.3.x API specification and generated examples across supported client, server, console, REST, and GraphQL targets, and updates the README to make 2.3.x the documented generation example.

  • Adds the 2.3.0 OpenAPI document with 756 paths, 1,027 operations, and 419 schemas.
  • Adds generated 2.3.x usage examples across the supported SDK platforms.
  • Updates version links and OpenAPI generation instructions in the README.
  • The generated Java examples need collection imports before they are usable as documented.

Reviews (1) · Last reviewed commit: "docs: list the 2.3.x specs and examples"

OAuthProvider.AMAZON, // provider
"https://example.com", // success (optional)
"https://example.com", // failure (optional)
List.of(), // scopes (optional)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Missing Java Collection Imports

This snippet calls List.of() but does not import java.util.List, so copying it into a Java or Android project fails to compile with an unresolved symbol. The same generator issue affects 266 new Java examples, including examples that use Map.of() without importing java.util.Map; please update the generator templates to emit the required imports.

Prompt To Fix With AI
This is a comment left during a code review.
Path: examples/2.3.x/client-android/java/account/create-o-auth-2-session.md
Line: 19

Comment:
**Missing Java Collection Imports**

This snippet calls `List.of()` but does not import `java.util.List`, so copying it into a Java or Android project fails to compile with an unresolved symbol. The same generator issue affects 266 new Java examples, including examples that use `Map.of()` without importing `java.util.Map`; please update the generator templates to emit the required imports.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Fix in Claude Code Fix in Codex

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Valid, but not new in 2.3.x: the published 2.2.x Java examples have the same missing java.util imports at about the same rate (123 vs 120 in a 400-file sample). The examples come from the sdk-generator Java templates, so the fix belongs there and will land in every version on the next regeneration. Not blocking this release.

@ChiragAgg5k
ChiragAgg5k merged commit af4c27c into main Sep 23, 2026
2 checks passed
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