Create Base Asset - Get Upload Link

POST 
/api/v2/rawmodel/api-upload/start

This endpoint initiates a new base asset upload process and returns:

1. An ID for the new base asset
2. Pre-signed URLs for direct file uploads to our s3 storage

Upload Process:

1. Call this endpoint to get the upload URLs
2. For each file in the s3_upload_urls:
   • Upload the file using an HTTP PUT request to the provided URL
3. After ALL files are uploaded, call the complete_upload URL to finalize the process

Step by Step Usage:

1. Upload mymodel.glb:
   • curl -X PUT -T "mymodel.glb" "use-signed-url-for-glb"
2. Upload material.mat:
   • curl -X PUT -T "material.mat" "use-signed-url-for-mat"
3. Finally, call the complete_upload URL:
   • curl -X POST "use-complete-upload-url"

Request

application/json

Body

required

model_name stringrequired

The name of the base asset

filenames string[]required

The names of the files to be uploaded

is_zip boolean

Indicate if the file is a zip

Responses

200

success

application/json

Schema

Schema

id integer
links object
s3_upload_urls object
mymodel.glb string
material.mat string
complete_upload string

Example (from schema)

{
  "id": 1,
  "links": {
    "s3_upload_urls": {
      "mymodel.glb": "signed url for mymodel.glb",
      "material.mat": "signed url for material.mat"
    },
    "complete_upload": "https://api.rapidpipeline.com/api/v2/rawmodels/1/api-upload/complete"
  }
}

Loading...