Create Table

If you want to create a table and populate it with an initial dataset, you can do so by providing the data inline in the rows field (being sure that row object structure matches the table schema):

{
    "name": "Employees",
    "schema": { ... },
    "rows": [
        {
            "fullName": "Alex Bard",
            "ageInYears": 30,
            "hiredOn": "2021-07-03"
        }
    ]
}

However, this is only appropriate for relatively small initial datasets (around a few hundred rows or less, depending on schema complexity). If you need to work with a larger dataset you should utilize stashing.

Stashing is our process for handling the upload of large datasets. Break down your dataset into smaller, more manageable, pieces and upload them to a single stash ID.

Then, to create a table from a stash, you can use the $stashID reference in the rows field instead of providing the data inline:

{
    "name": "Employees",
    "schema": { ... },
    "rows": {
        "$stashID": "20240215-job32"
    }
}