curl/docs/cmdline-opts/post301.md
Daniel Stenberg fe9f68fa61
cmdline-opts: shorter help texts
In an effort to increase the readability of the "--help all" output on
narrow (80 column) terminals.

Co-authored-by: Jay Satiro

Closes #13169
2024-03-25 13:05:24 +01:00

25 lines
691 B
Markdown

---
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
SPDX-License-Identifier: curl
Long: post301
Help: Do not switch to GET after a 301 redirect
Protocols: HTTP
Added: 7.17.1
Category: http post
Multi: boolean
See-also:
- post302
- post303
- location
Example:
- --post301 --location -d "data" $URL
---
# `--post301`
Respect RFC 7231/6.4.2 and do not convert POST requests into GET requests when
following a 301 redirect. The non-RFC behavior is ubiquitous in web browsers,
so curl does the conversion by default to maintain consistency. However, a
server may require a POST to remain a POST after such a redirection. This
option is meaningful only when using --location.