Error Codes

Table 'x' not found. Did you mean 'y'?

Fix: Call hypertab_list_tables to see available tables.

Table 'x' already exists.

Fix: Choose a different name or delete the existing table.

Column 'x' not found on table 'y'.

Fix: Call hypertab_get_table_schema to see available columns.

Column 'x' already exists on table 'y'.

Fix: Use hypertab_update_column to modify it instead.

Table name must match /^[a-z][a-z0-9_]*$/.

Fix: Use lowercase letters, numbers, underscores. Start with a letter.

Column name must match /^[a-z][a-z0-9_]*$/.

Fix: Use lowercase letters, numbers, underscores. Start with a letter.

Names starting with '_ht_' are reserved.

Fix: Choose a name that does not start with _ht_.

Cannot modify system column '_ht_id'.

Fix: System columns (_ht_*) are managed by hypertab and cannot be renamed, retyped, or deleted.

Column 'x' already exists on table 'y'.

Fix: Choose a different column name or use hypertab_update_column to modify the existing one.

Table 'x' has been deleted.

Fix: Restore within 30 days: hypertab_restore_table({ table: "x" }).

Invalid input.

Fix: Check the parameter types and constraints.

Row 'id' not found.

Fix: Query rows first to find valid IDs.

This action requires confirm: true.

Fix: Add confirm: true to the arguments.

Batch size exceeds maximum of 10,000 rows.

Fix: Split your data into batches of 10,000 or fewer rows.

Invalid filter operator or value.

Fix: See /docs/filters for supported operators: eq, neq, gt, gte, lt, lte, contains, starts_with, in, between, is_null.

Column already has an active run.

Fix: Wait for the current run to complete.

Column 'x' is not a smart column.

Fix: Only smart columns (ai, http, formula, integration, lookup) can be run. Use hypertab_add_smart_column to create one.

Smart column paused: >50% error rate in 60s window.

Fix: Fix the underlying issue (API key, endpoint URL), then use hypertab_retry_failed_cells.

Invalid or missing API key.

Fix: Include Authorization: Bearer ht_sk_... header.

Plan limit reached.

Fix: Upgrade your plan or delete unused resources.

Rate limit or plan limit exceeded.

Fix: Reduce request rate or upgrade your plan.

Webhook 'id' not found.

Fix: Call hypertab_list_webhooks to see available webhooks.

Source 'id' not found.

Fix: Call hypertab_list_sources to see available sources.

Webhook delivery failed after retries.

Fix: Check the target URL is reachable and returns 2xx. Review webhook logs for details.

An internal error occurred.

Fix: Retry the request. If it persists, contact support.