Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Sets the redirect policy.

Component Version macOS Windows Linux Server iOS SDK
CURL 2.5 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "CURL.SetOptionPostRedir"; curl; Value )   More


Parameter Description Example
curl The CURL session handle. $curl
Value The new bitmask for redirections. 3


Returns "OK" on success.


Sets the redirect policy.
Pass a bitmask to control how libcurl acts on redirects after POSTs that get a 301 or 302 response back. A parameter with bit 0 set (value CURL_REDIR_POST_301) tells the library to respect RFC 2616/10.3.2 and not convert POST requests into GET requests when following a 301 redirection. Setting bit 1 (value CURL_REDIR_POST_302) makes libcurl maintain the request method after a 302 redirect. CURL_REDIR_POST_ALL is a convenience define that sets both bits.

The non-RFC behavior is ubiquitous in web browsers, so the library 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 setting CURL.SetOptionFollowLocation. (This option was known as CURLOPT_POST301 up to 7.19.0 as it only supported the 301 way before then)


See also POSTREDIR option in CURL manual.

See also

Blog Entries

Created 18th August 2014, last changed 3th February 2021

CURL.SetOptionPostQuote - CURL.SetOptionPreProxy