Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.writer.com/llms.txt

Use this file to discover all available pages before exploring further.

Sends an HTTP request to an API endpoint. Used to fetch or send data.

​
Overview

The HTTP Request block sends an HTTP request to an API endpoint. Use it to fetch data from external services, send data to APIs, or integrate with third-party systems. You can configure the HTTP method, URL, headers, body, and body type (plain text or JSON). The block supports GET, POST, PUT, PATCH, and DELETE methods.

​
Common use cases

  • Fetching data from a REST API
  • Sending data to a webhook or external service
  • Integrating with third-party tools
  • Automating workflows that require external communication

​
How it works

  1. Method: Choose the HTTP method, for example, GET, POST.
  2. URL: Enter the endpoint URL. Pass path parameters in the URL; for example, https://api.openweathermap.org/data/2.5/weather?q=@{payload.city}&appid=@{vault.openweather_key}&units=metric.
  3. Headers: Optionally specify headers as key-value pairs. You can also use secrets to access API keys and other sensitive values.
  4. Body type: Choose whether the body you are sending is text or JSON.
  5. Body: Enter the request body for POST, PUT, and PATCH requests.
The block sends the request and returns the response. If the request fails due to a connection error (for example, network timeout, DNS failure), it outputs a connection error. If the request receives an error response from the server (for example, 4xx or 5xx status code), it outputs a response error. You can access the error details in the next block using the @{message} variable.

​
Examples

​
External API integration

This example demonstrates making HTTP requests to an external API using a public API endpoint. It uses the Open-Notify API, which provides real-time data about the International Space Station (ISS); it’s free and requires no authentication, so you can use this example to test your workflow before you use it with another API. Blueprint flow:
  1. UI Trigger → Receives request to fetch ISS location
  2. HTTP Request → Calls Open-Notify API to get current ISS position
  3. Text generation → Creates location description based on the body of the response (@{result.body}), which contains the latitude and longitude of the ISS
  4. Set state → Stores the result of the text generation block in state variable to display in the UI
HTTP Request block configuration:
  • Method: GET
  • URL: http://api.open-notify.org/iss-now.json
  • Headers: None
  • Body type: None
  • Body: None
This workflow enables integration with external APIs to enhance your agent’s capabilities.

​
Fields

NameTypeControlDefaultDescriptionOptionsValidation
MethodText---
  • GET - GET
  • POST - POST
  • PUT - PUT
  • PATCH - PATCH
  • DELETE - DELETE
Allowed values: GET, POST, PUT, PATCH, DELETE,
URLTextTextarea----
HeadersKey-Value----
Body typeText-text-
  • text - Plain text
  • JSON - JSON
-
BodyTextTextarea----

​
End states

Below are the possible end states of the block call.
NameFieldTypeDescription
Success-successThe request was successful.
Response error-errorThe connection was established successfully but an error response code was received or the response was invalid.
Connection error-errorThe connection couldn’t be established.