Repository navigation
feat: API specs update for version latest with passkeys - #128
Merged
Merged
Conversation
Server, client and console SDKs released with passkeys are patched onto their last stable tags, so the latest spec documented methods and params none of them expose yet: email and recovery OTP, ID token sessions, avatar photos, the Appwrite messaging provider, Kakao, TikTok and Webflow OAuth2, the pwned and rotation password policies, Android signing fingerprints and custom membership IDs.
ChiragAgg5k
changed the title
ChiragAgg5k
added a commit
to appwrite/appwrite
that referenced
this pull request
Oct 12, 2026
The Cloud API reference reads specs 2.4.x, whose passkey policy still took origins. appwrite/specs#128 and #129 match latest and 2.4.x to the SDKs released with passkeys.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Regenerates
specs/latestfromappwrite-labs/cloudmain (Generate Specs run), then trims it to what the SDKs released today with passkeys ship (appwrite-labs/cloud#6491).Why
The Console's API Explorer reads
specs/latest. The Cloud API reference reads the newest numbered folder instead, and #129 makes the same fixes in2.4.x. The pinned commit (fcaf861) already lists the passkey methods, butproject.updatePasskeyPolicystill takesorigins, which the released SDKs dropped in favour ofrpIdalone.Trimmed by hand
Those SDK releases were patched onto each SDK's last stable tag, so they don't include everything the server spec now describes. Every method in the reference services was checked against the released SDKs'
docs/examples(node 29.3.0, web 28.2.0, console 18.4.0, and the other server and client SDKs, which match). Request params were checked against the npm type definitions.account.createEmailVerificationOTP,updateEmailVerificationOTP,createRecoveryOTP,updateRecoveryOTP,createIdTokenSession(still on client, where the SDKs ship them)avatars.updatePhoto,avatars.deletePhotomessaging.createAppwriteProvider,updateAppwriteProvider,project.updateOAuth2Kakao,updateOAuth2TikTok,updateOAuth2Webflow,updatePasswordPwnedPolicyproject.updatePasswordRotationPolicyfingerprintsproject.createAndroidPlatform,project.updateAndroidPlatformmembershipIdteams.createMembershipRemoving a platform only hides the method from that SDK's reference; the console spec keeps every method the Console SDK ships.
Not changed
The update also adds functions
interval(already in the released server SDKs), admin threats (console only, not in the reference) and response model defaults.A few older params already in
latestaren't in the released SDKs either (for examplereplyToEmailon messaging emails, OAuth2prompt, anddurationon email password sessions). They were in the reference before this update, so this PR leaves them alone.