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

  1. 1Update all references to use the new URL
  2. 2Follow the redirect using the same HTTP method
  3. 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

Related Redirection Codes