# Modal

> Make HTTP requests to Modal.run endpoints securely with custom headers, body, and configurable timeouts.

Source: https://cotera.co/docs/reference/tools/individual-tools/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:**

```json
{
  "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