Parameters

Parameter	Description
url	Required. The full URL, with http:// or https://. Surrounding spaces are removed.
body	Optional. The request body, sent as written. Without it, an empty body is sent. The Content-Type is not set by the engine: add it with $httpAddHeader when the API needs one.

Behavior

• The request is sent and the command waits for the response (within the command execution time budget). The function itself returns an empty string: the response is kept for $httpStatus (status code) and $httpResult (body). Each new request replaces the stored response of the previous one.
• Only http:// and https:// URLs are accepted. An empty URL raises HTTP request URL cannot be empty.; any other scheme raises an error.
• Headers added with $httpAddHeader before the call are sent with this request only.
• A network failure (connection refused, DNS error, …) raises an error; an HTTP error status (404, 500, …) does not: read it with $httpStatus.

Examples

Replace API Resource

$httpAddHeader[Content-Type;application/json]
$httpPut[https://api.example.com/configs/bot;{"theme":"dark"}]
$title[HTTP PUT Request]
$description[Request sent. Status: **$httpStatus**]
$color[#5865F2]