r-lib · hadley · Apr 28, 2019 · Jan 4, 2019 · Jan 4, 2019 · Apr 28, 2019
diff --git a/NEWS.md b/NEWS.md
@@ -1,5 +1,8 @@
 # httr (development version)
 
+* `POST` gains an example on how to use `encode = "raw"` for specific json
+  string body (@cderv, #563)
+
 * `http_status()` now throws the correct error message if http status code is 
   not in the list of known codes (@Javdat, #567).
 

diff --git a/R/http-post.r b/R/http-post.r
@@ -34,7 +34,15 @@
 #' POST(b2, body = list(x = "A simple text string"))
 #' POST(b2, body = list(y = upload_file(system.file("CITATION"))))
 #' POST(b2, body = list(x = "A simple text string"), encode = "json")
-#' 
+#'
+#' # body can also be provided as a json string directly to deal
+#' # with specific case, like an empty element in the json string.
+#' # passing as string directly
+#' POST(b2, body = '{"a":1,"b":{}}', encode = "raw")
+#' # or building the json string before
+#' json_body <- jsonlite::toJSON(list(a = 1, b = NULL), auto_unbox = TRUE)
+#' POST(b2, body = json_body, encode = "raw")
+#'
 #' # Various types of empty body:
 #' POST(b2, body = NULL, verbose())
 #' POST(b2, body = FALSE, verbose())

diff --git a/man/POST.Rd b/man/POST.Rd