Skip to main content

​
HTTP Request

The HTTP Request node makes HTTP calls to any external API or web endpoint. It supports all standard HTTP methods and a wide range of authentication types. HTTP Request Node

​
Use Cases

  • Call a REST API that does not have a dedicated AgentVerse integration
  • Interact with internal services or microservices
  • Fetch data from a third-party API and pass it to downstream nodes
  • Trigger webhooks on external platforms

​
Node Reference

​
Parameters

ParameterTypeRequiredDescription
MethodSelectYesHTTP method: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
URLStringYesThe full URL of the endpoint
AuthenticationSelectNoAuthentication method (see below)
Send HeadersBooleanNoEnable to add custom request headers
Send Query ParametersBooleanNoEnable to add query string parameters to the URL
Body TypeSelectNoFormat of the request body (for POST/PUT/PATCH)
BodyString / JSON / FormNoThe request body payload
Options — TimeoutNumberNoRequest timeout in milliseconds (default: 30000, max: 300000)
Options — Follow RedirectsBooleanNoWhether to follow HTTP redirects (default: enabled)
Options — Ignore SSL IssuesBooleanNoSkip SSL certificate verification (use with caution)

​
Body Types

TypeDescription
JSONSend body as application/json
Form Data (URL Encoded)Send body as application/x-www-form-urlencoded
Form Data (Multipart)Send body as multipart/form-data (for file uploads)
Raw / BinarySend raw string or binary body

​
Authentication

TypeDescription
NoneNo authentication
Basic AuthUsername and password via HTTP Basic Authentication
Bearer TokenAuthorization: Bearer <token> header
API KeyCustom header or query parameter with an API key
Digest AuthHTTP Digest Authentication
OAuth2OAuth2 Bearer token with automatic refresh
CustomManually specify any authentication header(s)

​
Output Data

By default, the node returns the parsed response body: 
{
  "users": [
    { "id": 1, "name": "Alice" },
    { "id": 2, "name": "Bob" }
  ]
}
When Full Response is enabled: 
{
  "statusCode": 200,
  "statusMessage": "OK",
  "headers": {
    "content-type": "application/json"
  },
  "body": { ... }
}
Reference fields in downstream nodes: 
{{ httpRequest.users[0].name }}
{{ httpRequest.statusCode }}

​
Pagination

For APIs that return paginated results, enable Pagination under Options:
SettingDescription
Pagination TypePage Number, Offset, or Cursor-Based
Max ItemsStop paginating after this many total items