connect_data
High-level data onboarding flow. Use this instead of advanced connector/source tools for normal users. Connect data once, pick the table/file/endpoint, and get a reusable dataset_id. If the result status is needs_selection, call connect_data again with connection_id and the chosen selection.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| csv | No | Raw CSV text for direct file_upload datasets. | |
| url | No | URL for direct file_upload or API datasets. | |
| records | No | Inline JSON records for direct file_upload datasets. | |
| json_str | No | Raw JSON text for direct file_upload datasets. | |
| provider | No | Legacy compatibility field for provider selection. Prefer connector.type plus connector.location/auth/options. | |
| connector | No | Canonical connector envelope with type/location/auth/options. Preferred when the same request shape should work across Python Runtime, TypeScript Runtime, and MCP. | |
| excel_b64 | No | Base64-encoded Excel payload. | |
| selection | No | Legacy compatibility field for chosen table/query/path. Use the selection object returned in choices when resuming a legacy connection flow. | |
| visibility | No | Shared requires admin/owner permissions. | |
| description | No | ||
| parquet_b64 | No | Base64-encoded Parquet payload. | |
| dataset_name | Yes | Name to save and reuse later. | |
| connection_id | No | Existing saved connection_id when resuming after selection. | |
| connection_name | No | Optional label for the saved connection. | |
| connection_type | No | Legacy compatibility field. Prefer connector.type with the canonical connector envelope. | |
| connection_config | No | Legacy compatibility field for connector credentials/config. Prefer connector.location and connector.auth.credentials. |