Utility

HTTP proxy, saved API accounts, 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.

Saved API Accounts

Store encrypted authentication headers with hypertab_save_api_account. HTTP and integration columns reference the returned account_id; inline credentials and credential-bearing URLs are rejected.

Save an API account

{
  "tool": "hypertab_save_api_account",
  "arguments": {
    "name": "Company data API",
    "service": "custom",
    "auth_type": "bearer",
    "token": "<api-token>",
    "base_url": "https://api.example.com"
  }
}

POST(server-side)hypertab_http_request

Make an HTTP request from Hypertab's infrastructure. Useful for calling APIs that block browser requests. Only public HTTP(S) destinations that pass Hypertab safety checks are supported. Private, local, metadata, redirecting, routing-header, and Hypertab-owned destinations are blocked.

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/public-users"
	}
}

GET/v1/statshypertab_get_stats

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

GET/v1/usage/summaryhypertab_get_usage_summary

Get smart-column call usage for today plus a 7-day breakdown and today's top columns by operations. Answers "how much have I used?" and "how close am I to my plan limits?".

GET(server-side)hypertab_get_errors

Get recent errors across supported workspace operations. Filter by current source categories such as webhook or system, or request all errors.

Import / Export

POST/v1/import/csvhypertab_import_csv

Synchronous CSV import for MCP/API usage. Can create a new Table inside a Project or append to an existing Table. Creating a Table requires project_id; omit it only when table identifies an existing Table. 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 (required for MCP/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
`project_id`	`string`	Required Project ID when table is omitted and the import creates a new Table
`has_headers`	`boolean`default: true	First record has headers
`mapping`	`object`	Optional per-header → target column mapping overrides

POST/v1/import/csv-upload

Background CSV upload path used by the web UI for large files. Files up to 5,000 records finish synchronously. Creating a new Table requires project_id; appends to an existing table do not. Larger files insert the first 100 preview records 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
`project_id`	`string`	Required Project ID when table is omitted and the upload creates a 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/v1/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/v1/import-jobs/:jobId

Poll a background CSV upload. Returns the live imported record count, total records, 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/v1/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/v1/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/v1/tables/:tableId/export/csvhypertab_export_csv

Export a table as CSV. Optionally select specific columns or filter records with a where clause. Returns a 1-hour download URL (CSV inlined for ≤100 records); hard cap of 50,000 records.

Parameter	Type	Description
`table`required	`string`	Table name or ID
`columns`	`string[]`	Columns to include (default: all)
`where`	`object \| array`	Optional filter to export a subset of records

Webhooks

Import / Export