What does HTTP status 449 (Retry With) mean?

 
Previous Next
HTTP_STATUS_BO_RESPONSE HTTP_STATUS_BLOCKED

HTTP_STATUS_RETRY_WITH

Some Microsoft products historically used 449 for a request that needs additional client action, but HTTP does not define interoperable semantics for this number. The response body and vendor documentation are authoritative.

Do not implement a generic automatic retry. Record the emitting server, headers, and payload, then identify the application-specific instruction before changing authentication, request data, or client behavior.

IANA HTTP Status Code Registry

Operational meaning of HTTP 449 for HTTP_STATUS_RETRY_WITH

HTTP 449 (HTTP_STATUS_RETRY_WITH) is a client-error response. AllStat records its meaning as “449 Retry With”. For HTTP_STATUS_RETRY_WITH, interpret it with the request method, selected representation, response headers, and the specification or product that defines the code; the number alone does not prove that application work completed.

Client and server handling for HTTP_STATUS_RETRY_WITH

  • Treat HTTP_STATUS_RETRY_WITH as a condition visible at the request boundary; inspect authentication, syntax, preconditions, routing, and resource state before retrying.
  • For HTTP_STATUS_RETRY_WITH, preserve the response body and challenge or retry-related headers because they often carry the actionable reason.
  • For HTTP_STATUS_RETRY_WITH, automatic retry is safe only when the method and status contract allow it and the request has been corrected.

For telemetry, record HTTP 449, method, authority, route template rather than secrets, response headers relevant to caching or retry, latency, upstream identity, and whether the response originated at the application or an intermediary.


Looking for a different code? Search another status or error code.