feat(http): add configurable timeout for API block requests

Adds timeout parameter to HTTP request tool and API block:
- Default timeout: 120000ms (2 minutes)
- Max timeout: 600000ms (10 minutes)
- User-friendly error message on timeout

This allows users to configure longer timeouts for slow API endpoints.

Fixes #2242

Author: majiayu000

apps/sim/blocks/blocks/api.ts

@@ -80,6 +80,14 @@ Example:
         generationType: 'json-object',
       },
     },
+    {
+      id: 'timeout',
+      title: 'Timeout (ms)',
+      type: 'short-input',
+      placeholder: '120000',
+      description:
+        'Request timeout in milliseconds. Default: 120000ms (2 min). Max: 600000ms (10 min).',
+    },
   ],
   tools: {
     access: ['http_request'],
@@ -90,6 +98,7 @@ Example:
     headers: { type: 'json', description: 'Request headers' },
     body: { type: 'json', description: 'Request body data' },
     params: { type: 'json', description: 'URL query parameters' },
+    timeout: { type: 'number', description: 'Request timeout in milliseconds' },
   },
   outputs: {
     data: { type: 'json', description: 'API response data (JSON, text, or other formats)' },

apps/sim/tools/http/request.ts

@@ -40,6 +40,12 @@ export const requestTool: ToolConfig<RequestParams, RequestResponse> = {
       type: 'object',
       description: 'Form data to send (will set appropriate Content-Type)',
     },
+    timeout: {
+      type: 'number',
+      default: 120000,
+      description:
+        'Request timeout in milliseconds. Default is 120000ms (2 minutes). Max is 600000ms (10 minutes).',
+    },
   },
 
   request: {

apps/sim/tools/http/types.ts

@@ -8,6 +8,7 @@ export interface RequestParams {
   params?: TableRow[]
   pathParams?: Record<string, string>
   formData?: Record<string, string | Blob>
+  timeout?: number
 }
 
 export interface RequestResponse extends ToolResponse {

apps/sim/tools/index.ts

@@ -648,14 +648,41 @@ async function handleInternalRequest(
     // Check request body size before sending to detect potential size limit issues
     validateRequestBodySize(requestParams.body, requestId, toolId)
 
-    // Prepare request options
-    const requestOptions = {
+    // Determine timeout: use params.timeout if provided, otherwise default to 120000ms (2 min)
+    // Max timeout is 600000ms (10 minutes) to prevent indefinite waits
+    const DEFAULT_TIMEOUT_MS = 120000
+    const MAX_TIMEOUT_MS = 600000
+    let timeoutMs = DEFAULT_TIMEOUT_MS
+    if (typeof params.timeout === 'number' && params.timeout > 0) {
+      timeoutMs = Math.min(params.timeout, MAX_TIMEOUT_MS)
+    } else if (typeof params.timeout === 'string') {
+      const parsed = Number.parseInt(params.timeout, 10)
+      if (!Number.isNaN(parsed) && parsed > 0) {
+        timeoutMs = Math.min(parsed, MAX_TIMEOUT_MS)
+      }
+    }
+
+    // Prepare request options with timeout signal
+    const requestOptions: RequestInit = {
       method: requestParams.method,
       headers: headers,
       body: requestParams.body,
+      signal: AbortSignal.timeout(timeoutMs),
     }
 
-    const response = await fetch(fullUrl, requestOptions)
+    let response: Response
+    try {
+      response = await fetch(fullUrl, requestOptions)
+    } catch (fetchError) {
+      // Handle timeout error specifically
+      if (fetchError instanceof Error && fetchError.name === 'TimeoutError') {
+        logger.error(`[${requestId}] Request timed out for ${toolId} after ${timeoutMs}ms`)
+        throw new Error(
+          `Request timed out after ${timeoutMs}ms. Consider increasing the timeout value.`
+        )
+      }
+      throw fetchError
+    }
 
     // For non-OK responses, attempt JSON first; if parsing fails, fall back to text
     if (!response.ok) {