docs-v2/content/v2.0/reference/flux/stdlib/http/post.md

title	description	aliases	menu	weight
http.post() function	The `http.post()` function submits an HTTP POST request to the specified URL with headers and data. The HTTP status code is returned.	/v2.0/reference/flux/functions/http/post/	v2_0_ref name parent http.post HTTP	202

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

Function type: Output

import "http"

http.post(
  url: "http://localhost:9999/",
  headers: {x:"a", y:"b", z:"c"},
  data: bytes(v: "body")
)

Parameters

url

The URL to POST to.

Data type: String

headers

Headers to include with the POST request.

Data type: Object

data

The data body to include with the POST request.

Data type: Bytes

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()
    |> tableFind(fn: (key) => exists key._level)
    |> getColumn(column: "_level")

http.post(
  url: "http://myawsomeurl.com/api/notify",
  headers: {Authorization: "Bearer mySuPerSecRetTokEn"},
  data: bytes(v: lastReported[0])
)