pds#

Comparison of endpoints and parameters between this implementation and the official AT Protocol PDS.

Endpoints Missing from pds.js#

Endpoint	Params
deleteAccount	did
disableAccountInvites	account, note
disableInviteCodes	accounts, codes
enableAccountInvites	account, note
getAccountInfo	did
getAccountInfos	dids
getInviteCodes	cursor, limit, sort
getSubjectStatus	blob, did, uri
searchAccounts	cursor, email, limit
sendEmail	comment, content, recipientDid, senderDid, subject
updateAccountEmail	account, email
updateAccountHandle	did, handle
updateAccountPassword	did, password
updateAccountSigningKey	did, signingKey
updateSubjectStatus	deactivated, subject, takedown

Endpoint	Params	Notes
getRecommendedDidCredentials	(none)
refreshIdentity	identifier
requestPlcOperationSignature	(none)
resolveDid	did
resolveIdentity	identifier
signPlcOperation	alsoKnownAs, rotationKeys, services, token, verificationMethods
submitPlcOperation	operation
updateHandle	handle

pds.js only implements: resolveHandle

Endpoint	Params
activateAccount	(none)
checkAccountStatus	(none)
confirmEmail	email, token
createAccount	did, email, handle, inviteCode, password, plcOp, recoveryKey, verificationCode, verificationPhone
createAppPassword	name, privileged
createInviteCode	forAccount, useCount
createInviteCodes	codeCount, forAccounts, useCount
deactivateAccount	deleteAfter
deleteAccount	did, password, token
deleteSession	(none)
getAccountInviteCodes	createAvailable, includeUsed
getServiceAuth	aud, exp, lxm
listAppPasswords	(none)
requestAccountDelete	(none)
requestEmailConfirmation	(none)
requestEmailUpdate	(none)
requestPasswordReset	email
reserveSigningKey	did
resetPassword	password, token
revokeAppPassword	name
updateEmail	email, emailAuthFactor, token

pds.js implements: createSession, getSession, refreshSession, describeServer

pds.js implements: listRepos, getLatestCommit, getRepoStatus, getRepo, getRecord, getBlob, listBlobs, subscribeRepos

Endpoint	Params
importRepo	(binary)
listMissingBlobs	cursor, limit

pds.js implements: createRecord, deleteRecord, putRecord, applyWrites, getRecord, describeRepo, listRecords, uploadBlob

Endpoint	Params
createReport	modTool, reason, reasonType, subject

Endpoints that exist in both implementations, but pds.js is missing parameters:

Endpoint	pds.js has	Missing from pds.js
repo.createRecord	collection, record, rkey	repo, validate, swapCommit
repo.deleteRecord	collection, rkey	repo, swapCommit, swapRecord
repo.putRecord	collection, rkey, record	repo, validate, swapCommit, swapRecord
repo.applyWrites	writes	repo, validate, swapCommit
sync.getRepo	did	since
sync.listBlobs	did, cursor, limit	since
sync.listRepos	(none)	cursor, limit
server.createSession	identifier, password	allowTakendown, authFactorToken

Bold = likely important for compatibility

Both implementations handle app.bsky.* the same way:

Category	Endpoints	Notes
Native (stored in PDS)	actor.getPreferences, actor.putPreferences	Both implementations
Proxied to AppView	~87 endpoints	feed., graph., notification.*, etc.

Custom endpoints specific to this implementation:

Endpoint	Purpose
`POST /init`	Initialize PDS with DID/keys
`GET /status`	Health check
`POST /register-did`	Register a DID
`GET /get-registered-dids`	List registered DIDs
`POST /register-handle`	Register a handle
`GET /resolve-handle`	Resolve handle (non-XRPC path)
`POST /forward-event`	Forward sync events to other instances
`GET /repo-info`	Get repository info
`GET /oauth-public-key`	Get OAuth public key
`POST /check-dpop-jti`	DPoP replay protection

Endpoint	Purpose
`GET /.well-known/oauth-authorization-server`	OAuth server metadata
`GET /.well-known/oauth-protected-resource`	Protected resource metadata
`GET /oauth/jwks`	JSON Web Key Set
`POST /oauth/par`	Pushed Authorization Request
`GET/POST /oauth/authorize`	Authorization endpoint
`POST /oauth/token`	Token endpoint (with DPoP)
`POST /oauth/revoke`	Token revocation