Clarify handling of empty uploads (#197)

Empty uploads with `Upload-Length: 0` were previously already allowed but this PR explicitly mentions them and provides more context on how to handle them. This change is based on a question from #196.
tus · Apr 23, 2024 · 449ec91 · 449ec91
1 parent b671c1f
commit 449ec91
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/protocol.md b/protocol.md
@@ -359,6 +359,10 @@ not known, the Server MUST set `Upload-Defer-Length: 1` in all responses to
 If the Server supports deferring length, it MUST add `creation-defer-length` to
 the `Tus-Extension` header.
 
+The `Upload-Length` header MAY be set to 0, indicating that the Client wants to
+upload an empty file. Such an upload is immediately complete after its creation without
+transferring data using `PATCH` requests.
+
 The Client MAY supply the `Upload-Metadata` header to add additional metadata to the
 upload creation request. The Server MAY decide to ignore or use this information to
 further process the request or to reject it. If an upload contains additional