http.post() function

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:8086/",
  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: Record*

Header keys with special characters

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

{"key-1": "value 1", "key#2": "value 2" }

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()
    |> 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])
)