308
3xx RedirectionPermanent Redirect
The resource is permanently elsewhere, and the method must not change.
308 Permanent Redirect is the method-preserving version of 301: the resource has moved for good, and the client must repeat the request at the new URL with the same method and body. Reach for it when permanently moving API endpoints that take POST or PUT. Like 301, browsers cache it hard and search engines transfer ranking signal to the new URL.
What 308 looks like on the wire
POST /api/v1/orders HTTP/1.1 Host: api.example.com HTTP/1.1 308 Permanent Redirect Location: https://api.example.com/v2/orders
About 3xx Redirection
Further action is needed to complete the request, usually following a redirect to another URL.
How to fix 308 Permanent Redirect
- Use 308 (not 301) when moving endpoints that receive POST, PUT, or DELETE.
- Verify the target before shipping - like 301, a wrong 308 gets cached for a long time.
- Point old URLs straight at the final destination to avoid redirect chains.
Tools that help with 308
Where it's defined
308 Permanent Redirect is defined in RFC 9110 §15.4.9. MDN's 308 reference covers browser behavior and examples.