Docs
Steps

Call a web API

Send an HTTP request to a device or an online service

Then step — What happens. Step type then-http.

How it works

Calls a web address with GET, POST or another method, optional headers and body, and can save the reply (or a field of it) into a variable.

Example

Time of day (7:00 AM) → Call a web API (GET weather service, save temperature to "outdoorTemp") → Speak ("It is {{var.outdoorTemp}} degrees outside")

A spoken weather report from an online service.

Options

OptionKeyKindRequiredNotes
Methodmethodselectyesoptions: GET, POST, PUT, PATCH, DELETE
URLurltextyessupports {{…}} placeholders
HeadersheaderskeyValuenoup to 10 entries
Body typecontentTypeselectnooptions: json, text, form; shown when method is POST / PUT / PATCH / DELETE
Bodybodytextnomulti-line; shown when method is POST / PUT / PATCH / DELETE
Give up aftertimeoutSecondsdurationnoup to 30 s
Save the reply to a variablesaveTovariableno—
Only this JSON field (e.g. data.temp, items[0].id)savePathtextno—
Shared with other flowssharedbooleanno—

Wire format

What the step stores in the flow definition's data bag (JSON schema).

Generated from docs-bundle v0.1.0, novon-platform 9ce3486c (2026-10-09).

On this page