| Status code | 301 |
|---|---|
| Status text | Moved Permanently |
| Category | 3xx Redirection |
| Response has body | Usually |
| Specification | RFC 9110 |
What does 301 Moved Permanently mean?
The resource has permanently moved to the URL in the Location header. It belongs to the 3xx Redirection class, which means further action is needed to complete the request, usually following a different URL.
When do APIs return 301?
A domain migration, an HTTP-to-HTTPS upgrade, or an API version being retired.
How to fix a 301 Moved Permanently
Update your stored URL to the target in Location. Leaving old URLs in client code means every request pays a redirect round trip.
Reproduce a 301 response
The fastest way to understand a status code is to trigger one and read the full response. Open the
API tester and send a request to https://httpbin.org/status/301 — you will
see the 301 status along with every response header the server sent. Comparing those headers against
a working request is often what reveals the cause.
When you are debugging a real endpoint, check the response headers as carefully as the body, and confirm you are using the right HTTP method for the operation.
Related 3xx status codes
302 Found
The resource is temporarily at a different URL, but future requests should still use the original.
304 Not Modified
The cached copy the client already has is still valid, so no body is sent.
303 See Other
The response to the request can be found at another URL, and should be retrieved with GET.
307 Temporary Redirect
Like 302, but the HTTP method and body must be preserved when following the redirect.
308 Permanent Redirect
Like 301, but the method and body must be preserved.