This page documents the canonical HTTP contract for this endpoint.
Eligible bounded exports return a direct text/csv file response. When the direct path is not eligible (including size bounds) or direct export fails, the route falls through to queued background processing and returns the JSON admission envelope shown here. Poll status_url for completion; this JSON example is only the queued path.
Path parameters
table_idrequiredstring
The table ID.
| Name | Type | Description |
|---|---|---|
| table_idrequired | string | The table ID. |
Query parameters
filters· optionalstring
JSON-encoded filter object to export a subset of rows.
visible_column_ids· optionalstring
JSON-encoded array of column IDs to include. If omitted, all columns are exported.
| Name | Type | Description |
|---|---|---|
| filters | string | JSON-encoded filter object to export a subset of rows. |
| visible_column_ids | string | JSON-encoded array of column IDs to include. If omitted, all columns are exported. |
Errors
| Status | Meaning |
|---|---|
| 400 | Invalid filters or visible_column_ids JSON, no columns, or no selected columns. |
| 401 | Authentication required. |
| 403 | Access denied. |
| 404 | Table not found. |
| 503 | Failed to admit export. |
