xref: /curl/docs/cmdline-opts/post301.md (revision fe9f68fa)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: post301
5Help: Do not switch to GET after a 301 redirect
6Protocols: HTTP
7Added: 7.17.1
8Category: http post
9Multi: boolean
10See-also:
11  - post302
12  - post303
13  - location
14Example:
15  - --post301 --location -d "data" $URL
16---
17
18# `--post301`
19
20Respect RFC 7231/6.4.2 and do not convert POST requests into GET requests when
21following a 301 redirect. The non-RFC behavior is ubiquitous in web browsers,
22so curl does the conversion by default to maintain consistency. However, a
23server may require a POST to remain a POST after such a redirection. This
24option is meaningful only when using --location.
25