# 301 Moved Permanently

> The requested resource has been assigned a new permanent URI and future references should use it.

Source: https://apiguide.dev/status-codes/301
Class: redirection
Defined in: RFC 9110, Section 15.4.2 <https://www.rfc-editor.org/rfc/rfc9110.html#section-15.4.2>
Updated: 2026-07-09

## What does HTTP status code 301 mean?

The 301 Moved Permanently status code indicates that the target resource has been permanently moved to a new URI specified in the `Location` header.

## When to use it in APIs

Use when restructuring API paths (e.g., moving `/v1/leads` to `/v2/leads` permanently). However, be aware that many HTTP clients will change post requests to GET requests when following a 301.

## How it compares to other codes

* **308 Permanent Redirect**: The modern replacement that guarantees the HTTP method (e.g. POST) remains unchanged during redirect.
* **302 Found**: A temporary redirect.