[BUG] Inconsistent URL patterns in platform.claude.com API reference documentation

Preflight Checklist

• [x] I have searched existing issues and this hasn't been reported yet
• [x] This is a single bug report (please file separate reports for different bugs)
• [x] I am using the latest version of Claude Code

What's Wrong?

The API reference documentation at platform.claude.com uses inconsistent URL patterns between the generic API docs and SDK-specific docs (Python/TypeScript).

• Generic API: /docs/en/api/models-list (hyphenated) → 200 OK
• Python SDK: /docs/en/api/python/models-list (hyphenated) → 503 Error
• Python SDK: /docs/en/api/python/models/list (nested) → 200 OK

The hyphenated URL pattern works for generic API but returns 503 for SDK-specific pages.

What Should Happen?

URL patterns should be consistent. Either:

1. Support both patterns everywhere, OR
2. Redirect hyphenated URLs to nested URLs for SDK sections

Error Messages/Logs

HTTP 503 Service Unavailable
URL: https://platform.claude.com/docs/en/api/python/models-list

Steps to Reproduce

1. Open browser or use curl/fetch
2. Navigate to https://platform.claude.com/docs/en/api/models-list

• Result: Page loads (200 OK)

1. Navigate to https://platform.claude.com/docs/en/api/python/models-list

• Result: 503 Service Unavailable

1. Navigate to https://platform.claude.com/docs/en/api/python/models/list

• Result: Page loads (200 OK) - same content expected from step 3

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.1.16

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

Affected URL Patterns

| URL Pattern | Generic API | Python SDK | TypeScript SDK |
|-------------|-------------|------------|----------------|
| /models | 200 OK | 200 OK | 200 OK |
| /models-list | 200 OK | 503 | 503 |
| /models/list | 200 OK | 200 OK | 200 OK |

Impact

• Broken URLs for users navigating SDK documentation
• Inconsistent user experience across API reference sections
• Potential SEO/crawler issues

Additional Note

The sitemap at platform.claude.com/sitemap.xml does not include API reference URLs - they're only discoverable via link crawling from the main docs pages.