Upload Assets
Upload files from URLs to a project in Trellis to be processed later. You need to create a project and get the proj_id
before uploading assets.
Authorizations
Headers
Pass in an API version to guarantee a consistent response format.
The latest version should be used for all new API calls. Existing API calls should be updated to the latest version when possible.
Valid versions:
-
Latest API version (recommended):
2025-03
-
Previous API version (maintenance mode):
2025-02
If no API version header is included, the response format is considered unstable and could change without notice (not recommended).
Body
A list of file URLs to be downloaded and processed during the upload.
The ID of the project to which the assets will be uploaded and assigned.
Specify if the uploaded assets should be processed exclusively by a particular transformation.
Optional. Specify the file types for each URL (e.g., 'csv', 'xlsx'). If not provided, defaults will be used based on content.
Optional. External identifiers for the files, useful for mapping or reference.
Optional. Names for the files to be uploaded. If not provided, names will be derived from the URLs.
Optional. Define how files should be split during processing. Supported values are new_line
(split rows by newline for CSV/Excel) or None
(no splitting).
Specify whether the input files include a header row. This applies to CSV or Excel files only.
Optional. Column names to be used as unique identifiers when chunking data. If not provided, all columns will be combined to generate unique identifiers.
Default file type to apply to all files if individual types are not specified.
Optional. Strategy to be used for parsing files during processing.
Optional. If provided, must also provide transform_id. Additionally, every url required a cell to upload the file into.
[
{
"row_id": "your-first-row-id",
"op_id": "your-first-operation-id"
},
{
"row_id": "your-second-row-id",
"op_id": "your-second-operation-id"
},
{
"row_id": "your-third-row-id",
"op_id": "your-third-operation-id"
}
]