[DOCS] platform.claude.com sitemap.xml is missing ~50+ valid documentation pages

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:

1. Sidebar navigation links on existing pages
2. 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:

1. All pages accessible via sidebar navigation
2. All pages linked from other documentation pages
3. 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