Docs · Sources
Sources
The first step of an import says where the data comes from. Rowvela reads public HTTPS addresses and files you upload, and shows you the response before anything else happens.
Source formats
| Source format | Use it for |
|---|---|
| REST API · JSON | Most APIs. Choose the list of records with Collection path. |
| GraphQL | GraphQL endpoints: GraphQL query, Variables (JSON object) and an optional operation name. |
| CSV file | CSV with a header row, UTF-8. The header names become source fields. |
| XML / RSS / Atom | XML documents and feeds, converted to the same structure as JSON. |
| Public image · attachment URL | An image URL written into an attachment field. |
Requests
- Request method: GET, POST, PUT, PATCH or DELETE. Inspecting and previewing send the request, so a PUT, PATCH or DELETE changes the source each time.
- Request body: JSON, form URL encoded, form-data with text and files, plain text, XML, or an Airtable attachment as a binary body.
- Paste a cURL command (under the source settings) to fill in the URL, method, headers and body from API documentation. Credentials in the command move to encrypted storage.
- Headers and query parameters of your own, with workspace variables such as
{{api_base}}. - Retries happen automatically only for GET requests, so a failed POST is never sent twice.
Uploaded files
Choose Upload a file and add a UTF-8 .csv, .json or .xml file. Files are stored encrypted in the workspace and never get a public link. A file cannot be changed after upload: to import new data, upload a new version and preview again. During the pilot a file can have up to 250 MB, and a workspace up to 20 files and 1 GB.
Another Airtable base
Set Authentication to Existing Airtable connection to read a table or view from Airtable as the source, then map it like any API.
Saved configurations and Data Fetcher
On the overview, Import configuration loads an import exported from Rowvela, or a request exported from Data Fetcher. Exports never contain secrets, so choose the connection and credentials again. A converted Data Fetcher request lists what could not be carried over; review it, choose the match field and preview before running.
Limits
| Limit | Value |
|---|---|
| Response size | 5 MB per response |
| Pages per run | up to 500 |
| Records per run and per table | 100,000 by default |
| Request timeout | 20 seconds |
Rowvela connects only to public HTTPS addresses on port 443. Private and internal network addresses are blocked, and redirects are not followed.