feat: API specs update for version latest#64
feat: API specs update for version latest#64appwrite-specs[bot] wants to merge 1 commit intomainfrom
Conversation
Greptile SummaryThis PR bumps all six API specs from version 1.9.3 to 1.9.4, introducing new proxy rule management endpoints, bigint attribute/column endpoints, and several breaking renames in the console spec.
Confidence Score: 3/5The new redirect rule endpoint has a type mismatch between request and response that will cause SDK generation issues. The
Important Files Changed
Reviews (3): Last reviewed commit: "chore: update API specs and SDK examples" | Re-trigger Greptile |
287104a to
b180840
Compare
| @@ -1,7 +1,7 @@ | |||
| { | |||
There was a problem hiding this comment.
Breaking path rename:
/proxy/rules/{ruleId}/verification → /proxy/rules/{ruleId}/status
The endpoint path, operationId (proxyUpdateRuleVerification → proxyUpdateRuleStatus), and SDK method name (updateRuleVerification → updateRuleStatus) all changed in the same commit. Any existing console SDK client that calls PATCH /v1/proxy/rules/{ruleId}/verification will receive a 404 at runtime. The same rename appears in swagger2-latest-console.json. This should be coordinated with a corresponding console SDK release, or the old path should be preserved as a deprecated alias during a transition period.
| @@ -1,7 +1,7 @@ | |||
| { | |||
There was a problem hiding this comment.
Removed
"created" value from rule status enum
The status field of the proxyRule schema previously enumerated four values: "created", "verifying", "verified", "unverified". This PR drops "created" down to three values. Any console client that reads a rule object and branches on status === "created" will now silently fall through to its default/unknown branch. The same change appears in swagger2-latest-console.json. If the server still returns "created" for older rule objects, clients following the new spec will mishandle those responses.
b180840 to
c73222d
Compare
| "statusCode": { | ||
| "type": "string", | ||
| "description": "Variable value. Max length: 8192 chars.", | ||
| "x-example": "<VALUE>" | ||
| "description": "Status code of redirection", | ||
| "x-example": "301", | ||
| "enum": [ | ||
| "301", | ||
| "302", | ||
| "307", | ||
| "308" | ||
| ], | ||
| "x-enum-name": null, | ||
| "x-enum-keys": [ | ||
| "Moved Permanently 301", | ||
| "Found 302", | ||
| "Temporary Redirect 307", | ||
| "Permanent Redirect 308" | ||
| ] |
There was a problem hiding this comment.
Type mismatch:
statusCode request parameter vs redirectStatusCode response field
The proxyCreateRedirectRule request body defines statusCode as type: "string" (line 37143), while the proxyRule response schema defines redirectStatusCode as type: "integer" (line 70863). SDK generators will produce mismatched types for the same conceptual value — callers must pass the string "301" but will receive back the integer 301. The same mismatch is present in swagger2-latest-server.json. Either both should be strings (with the enum on the request side) or both should be integers.
This PR contains API specification updates for version latest.