POST
/
v1
/
assets
/
upload
curl --request POST \
  --url https://api.runtrellis.com/v1/assets/upload \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "proj_id": "<string>",
  "transform_id": "<string>",
  "urls": [
    "<string>"
  ],
  "file_types": [
    "<string>"
  ],
  "ext_ids": [
    "<string>"
  ],
  "ext_file_names": [
    "<string>"
  ],
  "chunk_strategy": "<string>",
  "include_header": true,
  "main_keys": [
    "<string>"
  ],
  "file_type": "<string>",
  "parse_strategy": "<string>",
  "cells": [
    {
      "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"
    }
  ]
}'
{
  "message": "<string>",
  "metadata": {
    "total_results_count": 123,
    "total_filtered_results_count": 123
  },
  "data": [
    {
      "asset_id": "<string>",
      "ext_file_name": "<string>",
      "ext_file_id": "<string>",
      "file_type": "<string>",
      "url": "<string>",
      "status": "uploading",
      "proj_id": "<string>",
      "transform_id": "<string>",
      "entity_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

Authorization
string
header
required

Headers

API-Version
string

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

application/json

Response

200
application/json
Successful Response

The response is of type object.