Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.

HTTP 424 Failed Dependency means a requested method could not run because another action it required had already failed. The status is defined for WebDAV, where one property change or resource operation can block dependent work. Find the first failed operation, correct it, and then deliberately rerun the dependent request; changing or retrying the 424 request alone usually does not address the cause.

What HTTP 424 means

RFC 4918 defines 424 as a dependency failure: “The 424 (Failed Dependency) status code means that the method could not be performed on the resource because the requested action depended on another action.” In practical terms, the server is telling you that your request was not independently executable. A prerequisite operation failed, so the server stopped the later operation as well.

The number is part of the WebDAV extension to HTTP, not a general replacement for every failed API request. Standard WebDAV methods can involve several related changes in one workflow. If an earlier change does not succeed, later changes may receive 424 even when their individual syntax is valid.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Why it is usually a downstream symptom

A 424 response often identifies where the workflow stopped, not where it originally went wrong. For example, a property update may depend on a lock, a valid parent resource, or another property being created first. The dependent update then fails because the required state was never reached. Your first debugging target should therefore be the earliest failed action in the chain.

Where 424 appears: WebDAV workflows

WebDAV adds methods and response formats for authoring and managing resources over HTTP. The canonical 424 example is PROPPATCH, which changes one or more properties on a resource. A server can report each property’s result in a 207 Multi-Status response. If one property change fails, a related or dependent change can be reported with a 424 status because its prerequisite state was not established.

Typical sequence

  1. Your client sends a WebDAV operation that includes multiple changes or relies on an earlier operation.
  2. The server evaluates the prerequisite action first.
  3. That action fails—for example, because of an invalid property, a missing resource, or a state conflict.
  4. The server declines the dependent action and reports 424, often in a per-resource or per-property status element.
  5. You correct the original failure and submit the workflow again when it is safe to do so.

Because WebDAV commonly returns detailed multi-status XML, the HTTP status line is only part of the diagnosis.

How to diagnose a 424 response

1. Record the exact operation

Capture the method, URL, request headers, body, response headers, and complete response body. Note whether 424 was the top-level HTTP status or appeared inside a 207 Multi-Status XML document. A proxy, framework, or API gateway may also translate an internal dependency error into a 424 response.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

2. Read the response body before changing the request

Look for WebDAV elements such as <response>, <propstat>, <status>, and <error>. The body may identify the resource, property, or prerequisite that failed. Preserve the XML exactly when opening a support ticket; flattening it to only the status code can hide the useful detail.

3. Find the earliest failed action

Trace the workflow in dependency order. Check the operation immediately before the 424, then continue backward until you find a non-success response or a server-side exception. Review WebDAV server logs, application logs, and reverse-proxy logs at the same timestamp. The first failure is normally the corrective action; the 424 is the consequence.

4. Verify resource and request state

  • Confirm that the target URL identifies the intended resource and that its parent collections exist.
  • Check authentication and authorization for every operation in the sequence, not only the final request.
  • Inspect lock state and lock tokens when the resource is locked or requires a lock.
  • Validate XML namespaces, property names, and the request’s content type.
  • Check conditional headers such as If and If-Match, which can prevent the prerequisite operation from succeeding.

5. Re-run intentionally

After fixing the prerequisite, repeat the dependent operation with a fresh request. Do not assume that a generic retry loop will help: RFC 4918 defines the dependency relationship but does not specify a universal retry interval or automatic-retry policy. Repeating too quickly can reproduce the same failed state or duplicate a partially successful change.

Example: inspecting a WebDAV multi-status response

A diagnostic response may look conceptually like this (the exact XML and reason phrase depend on the server):

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
<multistatus xmlns="DAV:">
  <response>
    <href>/docs/report.docx</href>
    <propstat>
      <prop><displayname/></prop>
      <status>HTTP/1.1 424 Failed Dependency</status>
      <error><dependency-failed/></error>
    </propstat>
  </response>
</multistatus>

Treat this as a parsing pattern, not a required server payload. Some implementations return a different error element or explain the prerequisite in plain text. Always use the actual body and server documentation as the authority.

424 compared with nearby HTTP status codes

Status Primary cause What to investigate first Retry implication
412 Precondition Failed A request condition or conditional header was not satisfied. Check headers such as If-Match and the resource version. Refresh state and send a corrected condition; do not blindly repeat.
423 Locked The resource is locked. Identify the lock owner, token, and lock timeout. Retry only after obtaining or releasing the required lock.
424 Failed Dependency A prerequisite action failed. Locate and fix the earliest failed operation. No universal interval is defined; rerun deliberately after correction.
507 Insufficient Storage The server cannot store the representation needed to complete the method. Check server capacity, quotas, and the requested change size. Retry after storage or quota conditions are resolved.

These codes can occur in the same broader workflow, but they describe different causes. A 424 should not be “fixed” by treating it as a 412, 423, or 507 without evidence from the response and logs.

Why a non-WebDAV API might return 424

Regular web servers typically do not emit 424. If a JSON API that does not advertise WebDAV returns it, the application may be using the code for its own workflow semantics—for example, a job that depends on an earlier job, or a transaction whose setup step failed. In that case, the API’s documentation and response schema control the meaning. Apply the same diagnostic order: inspect the body, identify the prerequisite, and correct the first failed step.

Rank #3
Sale
HTTP: The Definitive Guide
  • Used Book in Good Condition

Do not infer that every 424 has the same dependency graph as a WebDAV PROPPATCH. The numeric code signals a dependency-style failure, but the application must explain which operation or state is required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Practical command-line investigation

Capture headers and body with cURL

curl --verbose 
  --request PROPPATCH 
  --header 'Content-Type: application/xml; charset="utf-8"' 
  --header 'Authorization: Bearer YOUR_TOKEN' 
  --data-binary @property-change.xml 
  https://dav.example.com/docs/report.docx 
  --dump-header response.headers 
  --output response.body

Use --verbose to see the request and connection exchange, save headers separately, and inspect response.body as XML. Redact credentials and sensitive document names before sharing logs.

Check the prerequisite independently

Repeat the preceding operation with the same authentication, lock token, conditional headers, and target URL. Compare its status and body with the successful path documented by your WebDAV server. If the prerequisite succeeds but the next request still returns 424, check whether a proxy is serving a stale response or whether the server requires a new transaction or lock token.

Common causes and fixes

Invalid or unsupported property

A property in a PROPPATCH body may be read-only, in the wrong namespace, or rejected by the server. Remove or correct that property first, then submit dependent changes again.

Missing parent or target resource

If an earlier create or move operation failed, a later property update can become a failed dependency. Confirm each URL with a separate request and correct path, collection, or naming errors before updating metadata.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4

Lock or conditional-state failure

A stale lock token, expired lock, or mismatched entity tag can stop the prerequisite action. Obtain the current lock information or refresh the resource version, then rebuild the request with current state rather than replaying old headers.

Partial success in a batch

Multi-operation requests can leave some changes applied and others rejected. Read every per-property status, record what succeeded, and make the next request idempotent where possible. Sending the original batch unchanged may overwrite successful work or trigger another dependency failure.

Gateway or application translation

When 424 comes from a non-WebDAV service, inspect gateway logs and the API’s error object. A queue, workflow engine, or internal transaction may have its own prerequisite identifier. Follow that identifier to the failed job or step instead of debugging HTTP transport alone.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Performance, reliability, and retry design

Dependency failures are often deterministic, so high-frequency retries increase load without improving success. Record a correlation ID, stop dependent work, repair the prerequisite, and then resume from a known state. For automated clients:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Parse both top-level HTTP status and per-resource statuses in 207 responses.
  • Persist operation IDs or idempotency keys so recovery does not duplicate successful changes.
  • Use bounded retries only for a documented transient prerequisite; otherwise surface an actionable error.
  • Emit metrics that distinguish the first failed operation from downstream 424 responses.
  • Keep request and response bodies available for a short, access-controlled diagnostic window.

Or skip the browser setup

If you need a clean visual record of an error page or a workflow result while documenting an incident, ScreenshotNeo can capture the URL through one API call. It accepts consent banners before capture and removes more than 60 known consent platforms, newsletter popups, and chat widgets; bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers identify the page verdict and billing result. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients.

See the ScreenshotNeo documentation for all options, including custom headers and cookies when an incident page requires authentication.

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

There is a free allowance of 1,000 screenshots each month with no card; paid plans start at $5 for 3,000 shots. Create a free ScreenshotNeo account to try it.

When to contact the server or API owner

Escalate when the prerequisite succeeds in an isolated request but the dependent operation still returns 424, when the response omits enough detail to identify the dependency, or when different nodes return contradictory results. Include the timestamp, request method and path, sanitized headers, full response body, resource identifier, lock or version information, and the earliest failed operation. That evidence lets the operator distinguish a client-state problem from a server workflow defect.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Frequently Asked Questions

Is HTTP 424 a client error or a server error?

It is in the 4xx class, but the class alone does not prove that the client made the original mistake. The response says the requested method could not proceed because a prerequisite action failed; the prerequisite may involve client state, resource state, or an application workflow.

Should I retry immediately after receiving 424?

Not by default. First identify and correct the failed prerequisite. Then repeat the operation intentionally, using current locks, versions, and resource state. The HTTP specification does not define one universal retry delay for 424.

Can a JSON REST API legitimately use 424?

It can choose the status for an application-defined dependency workflow, although 424 originated in WebDAV. Read that API’s documentation and error body to learn which job, transaction, or step must succeed first.

Quick Recap

SaleBestseller No. 3
HTTP: The Definitive Guide
HTTP: The Definitive Guide
Used Book in Good Condition
$26.04
SaleBestseller No. 4
HTTP Pocket Reference: Hypertext Transfer Protocol
HTTP Pocket Reference: Hypertext Transfer Protocol
Used Book in Good Condition
$6.94
Bestseller No. 5

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.