Utility

HTTP proxy, AI provider management, workspace stats, error monitoring, and CSV import/export. Large CSV uploads use a background job path so the table stays usable while the import finishes.

AI Providers

Save API keys for AI providers (Google, OpenAI, Anthropic, Groq, DeepSeek, Mistral). Saved keys are reused across all AI smart columns, no need to paste keys into column config. Provider is auto-detected from the API key format.

AI Agents

Always check saved providers with hypertab_list_ai_providers before creating AI columns. Use provider_id in the column config instead of raw API keys.

Save AI Provider

POST/api/settings/ai-providershypertab_save_ai_provider

Save an API key. Provider auto-detected from key format: AIza* = Google,sk-ant-* = Anthropic,sk-* = OpenAI,gsk_* = Groq. First key for a provider becomes the default.

Parameter	Type	Description
`label`required	`string`	Human-readable label (e.g. "My Gemini Key", "Work OpenAI")
`api_key`required	`string`	The API key. Provider auto-detected from format.
`provider`	`string`	Override auto-detection: openai, anthropic, google, groq, mistral, deepseek
`is_default`	`boolean`default: false	Set as default for this provider type

{
  "tool": "hypertab_save_ai_provider",
  "arguments": {
    "label": "My Gemini Key",
    "api_key": "AIzaSy..."
  }
}

List AI Providers

GET/api/settings/ai-providershypertab_list_ai_providers

List saved providers with available models. Keys are never exposed.

{ "tool": "hypertab_list_ai_providers" }

POST(server-side)hypertab_http_request

Make an HTTP request from hypertab's infrastructure. Useful for calling APIs that block browser requests.

Parameter	Type	Description
`method`required	`string`	GET, POST, PUT, PATCH, or DELETE
`url`required	`string`	Target URL (must be HTTPS for external)
`headers`	`object`	Request headers
`body`	`object \| string`	Request body
`timeout`	`integer`default: 30	Timeout in seconds (max 60)

MCP

{
  "tool": "hypertab_http_request",
  "arguments": {
    "method": "GET",
    "url": "https://api.example.com/users",
    "headers": { "Authorization": "Bearer TOKEN" }
  }
}

GET/api/statshypertab_get_stats

Get workspace statistics: table count, total rows, active webhooks, functions, and plan info.

GET(server-side)hypertab_get_errors

Get recent errors across all operations. Filter by source: function, webhook, system, or all.

Import / Export

POST/api/import/csvhypertab_import_csv

Synchronous CSV import for MCP/API usage. Can create a new table or append to an existing one. The web app also uses this path for mapping preview via dry_run, sending the file as multipart form-data so the browser does not need to hold the whole CSV as a string.

Parameter	Type	Description
`data`	`string`	Raw CSV content for JSON requests
`file`	`multipart file`	CSV file for multipart/form-data requests
`table`	`string`	Existing table to append to (omit to create new)
`table_name`	`string`	Name for new table
`has_headers`	`boolean`default: true	First row has headers

POST/api/import/csv-upload

Background CSV upload path used by the web UI for large files. Files up to 5,000 rows finish synchronously. Larger files insert the first 100 preview rows immediately, then continue in the background with an import_id. This path is import-only by default: post-insert smart-column/webhook hooks stay off unless explicitly requested. Background work is processed in time-budgeted continuation slices so very large imports do not stall in one long queue invocation.

Parameter	Type	Description
`data`	`string`	Raw CSV content for JSON requests
`file`	`multipart file`	CSV file for multipart/form-data requests
`table`	`string`	Existing table to append to (omit to create new)
`table_name`	`string`	Name for new table
`mapping`	`object`	Optional header → target mapping from the review step
`run_post_insert_hooks`	`boolean`default: false	Set true only if import should trigger smart columns/webhooks

GET/api/import-jobs?table=...&status=...&limit=...

List recent background CSV jobs. Useful when you only have a table URL/name and need the latest import_id.

GET/api/import-jobs/:jobId

Poll a background CSV upload. Returns the live imported row count, total rows, status, and percentage complete. If status is completed but imported_rows < total_rows, read error_message for partial-skip details. Telemetry fields also show queue delay vs processing delay.

POST/api/import-jobs/:jobId/resume

Re-enqueue a stale or failed (non-cancelled) background import from its current progress offset. The web poller uses this for stale-job auto-recovery when queue telemetry flags are raised.

POST/api/import-jobs/:jobId/cancel

Cancel a pending or processing background CSV job. The job is marked as failed with Cancelled by user and queue continuation stops.

GET/api/tables/:tableId/export/csvhypertab_export_csv

Export a table as CSV. Optionally select specific columns.

Parameter	Type	Description
`table`required	`string`	Table name or ID
`columns`	`string[]`	Columns to include (default: all)

Webhooks

Import / Export