action.http, Make an HTTP request to an external API
Use action.http when a workflow needs to call an external service: enrich a
record, fetch a small JSON payload, or write a result into a system of record.
Template the URL, headers, and body from previous step output. Prefer short
timeouts and explicit failure handling. Non-2xx responses fail the step; only
eligible transient failures are retried.
Durable retries
OnlyGET and HEAD requests can use durable retries. In Studio, set the
workflow default under Workflow settings → Retries, then choose Inherit
workflow default, Retry automatically, or Never retry in this step’s
Retry control.
Retry-After, and stop after a
five-minute elapsed budget. Studio allows two or three total attempts,
including the first attempt. The YAML schema accepts up to 10, but the current
worker ceiling is three.
POST, PUT, PATCH, and DELETE are never replayed automatically because
they may have side effects. See Workflows → Retries
for workflow defaults and step overrides.
Configuration
Configuration goes inside the step’swith: block.
string
required
Request URL (supports template expressions)
"GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE"
default:"GET"
record<string, string>
HTTP headers
unknown
Request body (JSON or string)
number
default:"30000"
Timeout in milliseconds
boolean
default:"false"
If true, skip TLS certificate verification (use only for read-only public endpoints with bad/expired certs)
Output
HTTP status code
Response body (parsed JSON or string)
Charset used to decode the response body (e.g. utf-8, windows-1250)