Documentation Type
Incorrect/outdated documentation
Documentation Location
https://platform.claude.com/sitemap.xml
Section/Topic
Sitemap XML - missing documentation pages
Current Documentation
The sitemap at https://platform.claude.com/sitemap.xml returns 2,525 URLs, but after filtering to /docs/en/ paths, many valid documentation pages are missing.
What's Wrong or Missing?
The sitemap does not include numerous valid documentation pages that exist on the site. These pages are discoverable via:
- Sidebar navigation links on existing pages
- Internal markdown/HTML links within documentation content
Pages missing from sitemap (sample of 43 discovered):
Admin API endpoints:
/docs/en/api/admin-api/apikeys/get-api-key/docs/en/api/admin-api/apikeys/list-api-keys/docs/en/api/admin-api/invites/get-invite/docs/en/api/admin-api/organization/get-me/docs/en/api/admin-api/usage-cost/get-cost-report/docs/en/api/admin-api/usage-cost/get-messages-usage-report/docs/en/api/admin-api/claude-code/get-claude-code-usage-report/docs/en/api/admin-api/users/get-user/docs/en/api/admin-api/workspace_members/get-workspace-member/docs/en/api/admin-api/workspaces/get-workspace/docs/en/api/admin-api/workspaces/list-workspaces
Skills API:
/docs/en/api/skills/create-skill-version/docs/en/api/skills/list-skill-versions/docs/en/api/skills/list-skills
Message Batches API:
/docs/en/api/canceling-message-batches/docs/en/api/deleting-message-batches/docs/en/api/listing-message-batches/docs/en/api/retrieving-message-batch-results/docs/en/api/retrieving-message-batches
Core documentation:
/docs/en/build-with-claude/handling-stop-reasons/docs/en/build-with-claude/tool-use/docs/en/about-claude/models/extended-thinking-models/docs/en/claude_api_primer/docs/en/quickstart/docs/en/release-notes/api
Suggested Improvement
Update the sitemap generation process to include all valid documentation pages. The sitemap should be regenerated to include:
- All pages accessible via sidebar navigation
- All pages linked from other documentation pages
- All API reference pages (including nested endpoints)
A complete sitemap improves:
- SEO discoverability
- Documentation mirroring/archival tools
- Third-party integrations that rely on sitemap for content discovery
Impact
Medium - Makes feature difficult to understand
Additional Context
Discovery method: Built a documentation scraper that compares sitemap discovery vs. recursive crawling with sidebar link extraction.
Results:
| Discovery Method |
Pages Found |
| Sitemap (filtered to /docs/en/) |
~391 |
| Sidebar extraction |
+103 |
| Recursive link following |
+53 |
| Total unique pages |
547 |
This means approximately 40% of documentation pages are not in the sitemap.
Date verified: January 25, 2026
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://platform.claude.com/sitemap.xml
Section/Topic
Sitemap XML - missing documentation pages
Current Documentation
The sitemap at
https://platform.claude.com/sitemap.xmlreturns 2,525 URLs, but after filtering to/docs/en/paths, many valid documentation pages are missing.What's Wrong or Missing?
The sitemap does not include numerous valid documentation pages that exist on the site. These pages are discoverable via:
Pages missing from sitemap (sample of 43 discovered):
Admin API endpoints:
/docs/en/api/admin-api/apikeys/get-api-key/docs/en/api/admin-api/apikeys/list-api-keys/docs/en/api/admin-api/invites/get-invite/docs/en/api/admin-api/organization/get-me/docs/en/api/admin-api/usage-cost/get-cost-report/docs/en/api/admin-api/usage-cost/get-messages-usage-report/docs/en/api/admin-api/claude-code/get-claude-code-usage-report/docs/en/api/admin-api/users/get-user/docs/en/api/admin-api/workspace_members/get-workspace-member/docs/en/api/admin-api/workspaces/get-workspace/docs/en/api/admin-api/workspaces/list-workspacesSkills API:
/docs/en/api/skills/create-skill-version/docs/en/api/skills/list-skill-versions/docs/en/api/skills/list-skillsMessage Batches API:
/docs/en/api/canceling-message-batches/docs/en/api/deleting-message-batches/docs/en/api/listing-message-batches/docs/en/api/retrieving-message-batch-results/docs/en/api/retrieving-message-batchesCore documentation:
/docs/en/build-with-claude/handling-stop-reasons/docs/en/build-with-claude/tool-use/docs/en/about-claude/models/extended-thinking-models/docs/en/claude_api_primer/docs/en/quickstart/docs/en/release-notes/apiSuggested Improvement
Update the sitemap generation process to include all valid documentation pages. The sitemap should be regenerated to include:
A complete sitemap improves:
Impact
Medium - Makes feature difficult to understand
Additional Context
Discovery method: Built a documentation scraper that compares sitemap discovery vs. recursive crawling with sidebar link extraction.
Results:
This means approximately 40% of documentation pages are not in the sitemap.
Date verified: January 25, 2026