docs-v2/content/flux/v0/stdlib/http/post.md

title	description	menu	weight	flux/v0/tags	introduced
http.post() function	`http.post()` sends an HTTP POST request to the specified URL with headers and data and returns the HTTP status code.	flux_v0_ref name parent identifier http.post http http/post	101	single notification	0.40.0

http.post() sends an HTTP POST request to the specified URL with headers and data and returns the HTTP status code.

Function type signature

(url: string, ?data: bytes, ?headers: A) => int where A: Record

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

url

({{< req >}}) URL to send the POST request to.

headers

Headers to include with the POST request.

Header keys with special characters: Wrap header keys that contain special characters in double quotes ("").

data

Data body to include with the POST request.

Examples

Send the last reported status to a URL

import "json"
import "http"

lastReported =
    from(bucket: "example-bucket")
        |> range(start: -1m)
        |> filter(fn: (r) => r._measurement == "statuses")
        |> last()
        |> findColumn(fn: (key) => true, column: "_level")

http.post(
    url: "http://myawsomeurl.com/api/notify",
    headers: {Authorization: "Bearer mySuPerSecRetTokEn", "Content-type": "application/json"},
    data: json.encode(v: lastReported[0]),
)