Skip to content

Upload an asset file

Request

Create a new AssetUpload resource for an existing Asset.

Security
bearerToken
Bodyapplication/jsonrequired
assetIdstringrequired

The ID of the Asset to create an AssetUpload for

Example:"7af90a8b-7ccd-430f-a85d-e8614015bc47"
assetFileIdstring or null

The ID of the AssetFile to create am asset upload for. If null, a new AssetFile is created.

Example:"7af90a8b-7ccd-430f-a85d-e8614015bc47"
pathstringrequired

The path of the file including filename and any folders. This path will to set the value of the Asset Folder Field. Set to "/" to upload to the top-level in Dash.

Example:"/Folder A/Folder D/a_file.jpg"
sizeintegerrequired

The size of the file that is to be uploaded (in bytes)

Example:15318362
partSizeinteger or null, <= 5368709120

Optionally specify the part size (in bytes) for multi-part uploading of the file. This must be less than 5368709120, and more than 5242880 unless it is the final part. If omitted or null a default part size will be used.

Example:7000000
partUrlsRequestobject or null
curl -i -X POST \
  https://api-v2.dash.app/asset-uploads \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "assetId": "7af90a8b-7ccd-430f-a85d-e8614015bc47",
    "assetFileId": "7af90a8b-7ccd-430f-a85d-e8614015bc47",
    "path": "/Folder A/Folder D/a_file.jpg",
    "size": 15318362,
    "partSize": 7000000,
    "partUrlsRequest": {
      "uploadId": "5a2481e0-819f-4b46-a7e6-143f943345f2",
      "urlRequests": [
        {
          "partNumber": 2,
          "contentMd5": "86fb269d190d2c85f6e0468ceca42a20"
        }
      ]
    }
  }'

Responses

Success

Bodyapplication/json
resultobjectrequired
permittedActionsArray of objectsrequired
Response
{
  "result": {
    "id": "5a2481e0-819f-4b46-a7e6-143f943345f2",
    "assetId": "7af90a8b-7ccd-430f-a85d-e8614015bc47",
    "assetFileId": "7af90a8b-7ccd-430f-a85d-e8614015bc47",
    "uploadParts": [ … ]
  },
  "permittedActions": [
    { … }
  ]
}