Upload assets
Upload assets to library or task
- Fetch the pre-signed upload URL and its related meta fields using the
GET /v3/upload-url endpoint
. The validity time for this URL is 60 minutes. - Upload the file, along with the related meta fields, through an HTTP POST request to the pre-signed upload URL.
- Payload must be in
multipart/form-data
. - The field name for the file must be
file
. - Ensure that the meta fields are in the same order as they are received.
- The
file
field must be appended at the end. - If this URL is hit multiple times with the same meta fields, the last successfully uploaded file is used to create the asset in the next step.
- Payload must be in
- Upon success (204 HTTP response code) from the pre-signed URL, hit the POST endpoint for desired destination (library or task) passing the
key
which was previously obtained from theGET /v3/upload-url
endpoint and an arbitrarytitle
as the request payload. If this endpoint is hit multiple times with the samekey
, each time a new asset is created for the same uploaded file.
POST endpoints
- Add asset to Library –
POST /v3/assets
- Add version to a Library Asset –
POST /v3/assets/{asset_id}/versions
- Add asset to a Task –
POST /v3/tasks/{id}/assets
- Add draft to a Task Asset –
POST /v3/tasks/{task_id}/assets/{asset_id}/drafts
Updated 3 months ago