HTTP Request¶

The HTTP Request tool makes HTTP requests to external URLs and returns the status code and response body. It gives agents the ability to interact with REST APIs, fetch web pages, post data to webhooks, and communicate with any HTTP-accessible service.

Ports¶

Inputs¶

The url input is provided by the agent's LLM at invocation time. The agent can also specify method and body parameters in the tool call.

Outputs¶

The output format is HTTP {status_code}\n{response_body}.

Configuration¶

The HTTP Request tool accepts the following optional configuration in extra_config:

Example extra_config¶

{
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-..."
  },
  "timeout": 60
}

Usage¶

1. Add an HTTP Request node from the Node Palette
2. Connect it to an agent node via the green diamond tools handle
3. Optionally configure default method, headers, and timeout in Extra Config

The agent's LLM can then call the http_request tool with the following parameters:

Response handling¶

• Response bodies longer than 4,000 characters are truncated
• The result always starts with HTTP {status_code} followed by the response body
• Network errors and timeouts return Error: {details}

Example¶

An agent with an HTTP Request tool can fetch data from an API:

http_request(url="https://api.github.com/repos/theuselessai/Pipelit")

Returns:

HTTP 200
{"id":123456,"name":"Pipelit","full_name":"theuselessai/Pipelit",...}

A more advanced example with a POST request:

http_request(
    url="https://hooks.slack.com/services/T.../B.../xxx",
    method="POST",
    body='{"text": "Workflow completed successfully"}'
)

flowchart LR
    T[Chat Trigger] --> A[Agent]
    M[AI Model] -.->|model| A
    HR[HTTP Request] -.->|tool| A