Skip to main content

Export table as CSV

Export CSV directly for bounded tables or queue a background export for larger tables.

GET/api/tables/{table_id}/export/csv
HTTP referenceScope tables:readUpdated September 27, 2026

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_idrequired

    string

    The table ID.

Query parameters

  • filters · optional

    string

    JSON-encoded filter object to export a subset of rows.

  • visible_column_ids · optional

    string

    JSON-encoded array of column IDs to include. If omitted, all columns are exported.

Errors

StatusMeaning
400Invalid filters or visible_column_ids JSON, no columns, or no selected columns.
401Authentication required.
403Access denied.
404Table not found.
503Failed to admit export.

Docs