---
title: "HTTP Request"
description: "Connect to external APIs and web services"
icon: "globe"
---

The HTTP Request node connects your workflow to external APIs and web services. Use it to fetch data, send webhooks, upload files, or integrate with any service that accepts HTTP requests.

<Frame caption="HTTP Request node configuration">
  <img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/node/07c5e952eb4c9d6a32d0b7c2d855d4a5.png" alt="HTTP Request node interface" />
</Frame>

## HTTP Methods

The node supports all standard HTTP methods for different types of operations:

<Tabs>
  <Tab title="Data Retrieval">
    **GET** retrieves data from servers without modifying anything. Use for fetching user profiles, searching databases, or getting current status.
    
    **HEAD** gets response headers without the full response body. Useful for checking if resources exist or getting metadata.
  </Tab>
  
  <Tab title="Data Submission">
    **POST** sends data to servers, typically for creating new resources. Use for form submissions, file uploads, or sending JSON payloads.
    
    **PUT** creates or completely replaces resources. Use when you want to set the entire state of a resource.
    
    **PATCH** makes partial updates to existing resources. Use when you only need to modify specific fields.
  </Tab>
  
  <Tab title="Resource Management">
    **DELETE** removes resources from servers. Use for deleting files, user accounts, or any resource that should be removed.
  </Tab>
</Tabs>

## Configuration

Configure every aspect of your HTTP request including URL, headers, query parameters, request body, and authentication. Variables from previous workflow nodes can be dynamically inserted anywhere in your request configuration.

### Variable Substitution

Reference workflow variables using double curly braces: `{{variable_name}}`. Dify supports deep object access, so you can extract nested values like `{{api_response.data.items[0].id}}` from previous HTTP responses.

### Timeout Configuration

HTTP requests have configurable timeouts to prevent hanging:
- **Connect timeout**: Maximum time to establish connection (default varies by deployment)
- **Read timeout**: Maximum time to read response data
- **Write timeout**: Maximum time to send request data

Timeouts are enforced to maintain workflow performance and prevent resource exhaustion.

### Authentication

The node supports multiple authentication types:

**No Auth** (`type: "no-auth"`) - No authentication headers added

**API Key** (`type: "api-key"`) with three subtypes:
- **Basic** (`type: "basic"`) - Adds Basic Auth header with base64 encoding
- **Bearer** (`type: "bearer"`) - Adds `Authorization: Bearer <token>` header
- **Custom** (`type: "custom"`) - Adds custom header with specified name and value

### Request Body

Choose the appropriate body type based on your API requirements:

- **JSON** for structured data
- **Form Data** for traditional web forms
- **Binary** for file uploads
- **Raw Text** for custom content types

## File Detection

The HTTP Request node automatically detects file responses using sophisticated logic:

1. **Content-Disposition analysis** - Checks for `attachment` disposition or filename parameters
2. **MIME type evaluation** - Analyzes content types to distinguish text from binary
3. **Content sampling** - For ambiguous types, samples first 1024 bytes to detect text patterns

Text-based responses (JSON, XML, HTML, etc.) are treated as regular data, while binary content becomes file variables.

## File Operations

The HTTP Request node handles file uploads and downloads seamlessly:

<Frame caption="File upload configuration example">
  <img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/node/1f2e33cf7bed33096b5aee145006193d.png" alt="HTTP node file upload" />
</Frame>

**File Uploads** use the binary request body option. Select file variables from previous nodes to send files to external services for document storage, media processing, or backup.

**File Downloads** are automatically handled when responses contain file content. Downloaded files become available as file variables for use in downstream nodes.

## Error Handling and Retries

Configure robust error handling for production workflows that depend on external services:

<Frame caption="HTTP retry configuration">
  <img src="https://assets-docs.dify.ai/2024/12/2e7c6080c0875e31a074c2a9a4543797.png" alt="HTTP retry settings" />
</Frame>

**Retry Settings** automatically retry failed requests up to 10 times with configurable intervals (maximum 5000ms). This handles temporary network issues or service unavailability.

<Frame caption="HTTP error handling options">
  <img src="https://assets-docs.dify.ai/2024/12/91daa86d9770390ab2a41d6d0b6ed1e7.png" alt="HTTP error handling" />
</Frame>

**Error Handling** defines alternative workflow paths when HTTP requests fail, ensuring your workflow continues executing even when external APIs are unavailable.

## Response Processing

HTTP responses become structured variables in subsequent nodes with separate access to:

- **Response Body** - The main content returned by the API
- **Status Code** - HTTP status for conditional logic  
- **Headers** - Response metadata as key-value pairs
- **Files** - Any file content returned by the API
- **Size Information** - Content size in bytes with readable formatting (KB/MB)

### SSL Verification

SSL certificate verification is configurable per node (`ssl_verify` parameter). This allows connections to internal services with self-signed certificates while maintaining security for external APIs.

<Frame caption="Dynamic API integration example workflow">
  <img src="https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/node/090975269f8998f906c5636dde8d9540.png" alt="Customer Feedback Classification workflow" />
</Frame>

## Common Integration Patterns

**API Data Fetching** - Retrieve user profiles, product information, or external data to enrich your workflow processing.

**Webhook Delivery** - Send notifications, status updates, or processed results to external systems and services.

**File Processing** - Upload documents for analysis, download resources for further processing, or integrate with cloud storage services.

**Multi-step API Workflows** - Chain multiple API calls together, using responses from one request to configure subsequent requests.