feat: API specs update for version latest#45
feat: API specs update for version latest#45appwrite-specs[bot] wants to merge 1 commit intomainfrom
Conversation
Greptile SummaryThis PR updates API specs across all six latest spec files to add: bigint attribute/column CRUD endpoints (databases & tablesDB), a new
Confidence Score: 4/5Safe to merge after resolving the bigint demo path naming mismatch, which will cause broken links in SDK tooling. One P1 finding: the specs/latest/open-api3-latest-server.json, specs/latest/open-api3-latest-console.json, specs/latest/swagger2-latest-server.json, specs/latest/swagger2-latest-console.json — specifically the
|
| Filename | Overview |
|---|---|
| specs/latest/open-api3-latest-server.json | Adds bigint attribute/column endpoints, new project management endpoints, purge param, userType audit field, "x" OAuth provider — demo path for bigint uses "big-int" while edit URL uses "bigint" |
| specs/latest/open-api3-latest-console.json | Same bigint/column endpoints and new organization/migration endpoints; demo path inconsistency (big-int vs bigint) present |
| specs/latest/swagger2-latest-server.json | Swagger2 counterpart of server spec; same bigint demo path inconsistency present |
| specs/latest/swagger2-latest-console.json | Swagger2 counterpart of console spec; same bigint demo path inconsistency present |
| specs/latest/open-api3-latest-client.json | Client spec; adds "x" as a new OAuth2 provider and weight reordering — no issues found |
| specs/latest/swagger2-latest-client.json | Swagger2 client spec; minor weight reordering — no issues found |
Reviews (3): Last reviewed commit: "chore: update API specs and SDK examples" | Re-trigger Greptile
d01ccc2 to
482b8a3
Compare
| "default": { | ||
| "type": "integer", | ||
| "description": "Default value for attribute when not provided. Cannot be set when attribute is required.", | ||
| "x-example": 10, | ||
| "format": "int32", | ||
| "nullable": true | ||
| } |
There was a problem hiding this comment.
attributeBigint.default uses int32 format instead of int64
The default field in the attributeBigint response schema declares "format": "int32", while the sibling min and max fields correctly use "format": "int64". A bigint default value must support the full 64-bit range, so SDKs/tools that respect the format hint will truncate any default exceeding 2,147,483,647 when deserializing the response. The same issue exists in the columnBigint schema (line 54761) and is replicated across all six spec files.
| "default": { | |
| "type": "integer", | |
| "description": "Default value for attribute when not provided. Cannot be set when attribute is required.", | |
| "x-example": 10, | |
| "format": "int32", | |
| "nullable": true | |
| } | |
| "default": { | |
| "type": "integer", | |
| "description": "Default value for attribute when not provided. Cannot be set when attribute is required.", | |
| "x-example": 10, | |
| "format": "int64", | |
| "nullable": true | |
| } |
482b8a3 to
32e18f7
Compare
|
Tip: Greploop — Automatically fix all review issues by running Use the Greptile plugin for Claude Code to query reviews, search comments, and manage custom context directly from your terminal. |
This PR contains API specification updates for version latest.