Modal
Authentication Type: Service Account
Description: Make HTTP requests to Modal.run endpoints securely with custom headers, body, and configurable timeouts.
Requests
HTTP request operations for Modal.run endpoints.
Modal Request
Make an HTTP request to a Modal.run endpoint with custom headers and body content.
Operation Type: Mutation (Write)
Parameters:
- endpoint string(required): The Modal endpoint name (e.g., "my-function--data-processor-api" - will be automatically appended with .modal.run)
- method string(required): HTTP method to use (GET, POST, PUT, PATCH, DELETE) (default: POST)
- headers object(nullable): HTTP headers to include in the request as key-value pairs
- body string(nullable): Request body (JSON string or raw data)
- timeout number(required): Request timeout in milliseconds (default: 30000)
Returns:
- status number: HTTP status code (e.g., 200, 404, 500)
- statusText string: HTTP status text (e.g., "OK", "Not Found")
- headers object: Response headers as key-value pairs
- data string: Response body as string
Example Usage:
{
  "endpoint": "my-function--data-processor-api",
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "your-api-key"
  },
  "body": "{\"url\": \"https://example.com\", \"options\": {\"waitForSelector\": \".content\"}}",
  "timeout": 60000
}
Common Use Cases
Web Scraping & Data Extraction:
- Execute Modal serverless functions for web scraping operations
- Extract structured data from websites using custom endpoints
- Process scraped data with configurable timeout limits for long-running operations
API Integration & Orchestration:
- Connect to Modal serverless functions from external workflows
- Chain multiple Modal endpoints for complex data processing pipelines
- Integrate Modal's serverless capabilities into existing automation systems
Serverless Function Execution:
- Trigger Modal serverless functions with custom parameters and headers
- Execute computational tasks on Modal's infrastructure
- Handle responses from Modal functions for downstream processing
Batch Processing & Jobs:
- Submit batch processing jobs to Modal endpoints
- Monitor long-running jobs with extended timeout configurations
- Process large datasets using Modal's distributed computing capabilities