Docs: APNs token endpoints route under /device/ not /database/ (#382)

[leogdion]

Documentation-only. Records that Apple's archived CloudKit Web Services REST reference documents tokens/create / tokens/register under /database/, but the live service only routes them under /device/ (the /database/ path returns 405 Method Not Allowed, Allow: OPTIONS). MistKit already uses /device/; this captures the divergence so it isn't re-discovered.

Added a "Known Endpoint Discrepancies" section to .claude/docs/QUICK_REFERENCE.md (documented-vs-working path table + CloudKit JS setApiModuleName("device") rationale).

Closes #382.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: eeba1055-eba9-49bf-832f-3d017e3a0430

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/cloudkit-apns-endpoint-path

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[claude]

Review

Documentation-only PR — small, well-scoped, and accurate. Verified the claims against the current state of the repo:

• Accuracy: openapi.yaml already routes tokens/create / tokens/register under /device/{version}/{container}/{environment}/tokens/... (openapi.yaml:863, 913), with inline comments matching the rationale added here. The new doc section is a faithful, more discoverable restatement of that decision and of issue Docs: Apple's CloudKit Web Services reference documents APNs token endpoints under the wrong path (/database/ vs /device/) #382 — a useful "gotcha" to capture since it is not obvious from reading the OpenAPI spec alone.
• Placement: the new "Known Endpoint Discrepancies" section fits naturally between "Authentication Flow" and "Development Checklist," and the horizontal rules around it match the files existing section-separator convention.
• Content: links to Apples archived reference pages and to issue Docs: Apple's CloudKit Web Services reference documents APNs token endpoints under the wrong path (/database/ vs /device/) #382 are correct and useful for future readers who might otherwise rediscover the 405.

Minor/optional nits (non-blocking):

• The comparison tables header row is empty (| | Path |). Purely cosmetic — renders fine on GitHub — but a header like "Source | Path" would read slightly better and avoid an empty header cell.
• Slight redundancy: the "documented vs actually works" table repeats information already stated in the paragraph immediately above it. Not a real problem, just flagging in case you want to trim.
• Nice touch calling out that /device/ is container-scoped (no {database} segment) — an easy detail to miss when skimming and worth keeping prominent.

No code changes, no test coverage impact (nothing executable changed), no security or performance concerns. This looks good to merge as-is.