3xx Redirection
HTTP 308 Permanent Redirect
The resource has permanently moved to the URL specified in the Location header. Unlike 301, the request method must not change — a POST stays a POST. All future requests should use the new URL.
Common Causes
- Permanent redirect preserving the original HTTP method
- API version migration where method matters
- Domain change for non-GET endpoints
How to Fix
- 1Update all references to use the new URL
- 2Follow the redirect using the same HTTP method
- 3Update API client configurations with the new endpoint
Example
HTTP 308 Permanent Redirect
POST /api/v1/data HTTP/1.1 → 308 Permanent Redirect → Location: /api/v2/data → Client re-sends POST to new URL permanently