HTTP Request

Type ID: core.http  ·  Kind: Action  ·  Trace: TOOL

Makes an HTTP request to any URL using axios. Supports method selection, query parameters, headers, several body content types, basic/bearer authentication, and JSON or text response parsing.

Credentials

None

Properties

Property	Key	Type	Required	Default	Possible values	Shown when
Method	method	options	Yes	GET	GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS	Always
URL	url	string	Yes	''	Full URL (e.g. https://api.example.com/endpoint)	Always
Authentication	authentication	options	No	none	none — None; bearerToken — Bearer Token; basicAuth — Basic Auth	Always
Bearer Token	bearerToken	string	No	''	Bearer token string	authentication = bearerToken
Username	username	string	No	''	Basic-auth username	authentication = basicAuth
Password	password	string	No	''	Basic-auth password	authentication = basicAuth
Query Parameters	queryParameters	object	No	{}	Key/value object appended to the URL	Always
Headers	headers	object	No	{}	Key/value object of HTTP headers (values coerced to string)	Always
Body Content Type	bodyContentType	options	No	json	json — JSON; form — Form Data; form-urlencoded — Form URL-Encoded; raw — Raw	Always
Body	body	string	No	''	Request body for POST/PUT/PATCH. JSON object/string for JSON and form types	Always
Response Format	responseFormat	options	No	json	json — JSON; text — Text; autodetect — Auto Detect	Always
Options	options	object	No	{}	Collection of request options (see below)	Always

Options (nested fields)

Field	Key	Type	Default	Description
Timeout	timeout	number	30000	Request timeout in milliseconds
Follow Redirects	followRedirects	boolean	true	Whether to follow HTTP redirects
Ignore SSL Issues	ignoreSSL	boolean	false	Whether to ignore SSL certificate errors

Notes

• Parameters are resolved through the resolver engine before execution, so expressions are supported. A missing url throws URL is required for HTTP request.
• Request is issued with axios. timeout defaults to 30000 ms; maxRedirects is 0 when followRedirects is false, otherwise 5. When ignoreSSL is true an https.Agent with rejectUnauthorized: false is attached.
• Authentication: bearerToken sets an Authorization: Bearer <token> header; basicAuth sets axios auth from username/password. none adds nothing.
• Body is only sent for POST, PUT, PATCH (and only when body is truthy). json parses string bodies via JSON.parse (invalid JSON throws) and sets Content-Type: application/json. form/form-urlencoded build URLSearchParams from a parsed object and set Content-Type: application/x-www-form-urlencoded. raw sends the body unchanged.
• Response format text stringifies non-string responses; json and autodetect pass axios's parsed data through.
• On success the single output item is { statusCode, statusMessage, headers, body }. On failure an error item is built (error: true, statusCode, statusMessage, headers, body, message) but the node then throws HTTP Request failed (<status>): <message> rather than returning it.