Skip to content

401 Unauthorized

Meaning

The request has not been applied because it lacks valid authentication credentials for the target resource.

When to Use

When authentication is required and has either failed or not been provided. The response must include a WWW-Authenticate header field with a challenge for the client.

Example

Accessing a protected endpoint without a valid token returns 401 Unauthorized, prompting the client to provide credentials (WWW-Authenticate header might indicate the required scheme).

When Not to Use

Do not use if the client is authenticated but not allowed to access the resource (use 403 Forbidden in that case).

Source

RFC 9110


Released under the MIT License.