Skip to content

Import cloud objects

Request

Create a new Cloud Import Job resource to import assets into Dash

Security
bearerToken
Bodyapplication/jsonrequired
cloudConnectionIdstringrequired

The unique ID for the CloudConnection to import files from

Example:"e2b03444-8c5d-44ed-bd9f-7eee882bdf81"
selectorany
keepFolderStructurebooleanrequired

Whether to maintain the source folder structure beneath the selected objects

Example:true
destinationPathstringrequired

The path of the folder in Dash to import the files into. Use an empty string to import to the top level.

Example:"path/to/folder"
pathMappingsArray of objects

A list of [CloudObjectPathMapping]s to apply to the imported [CloudObject]s

curl -i -X POST \
  https://api-v2.dash.app/cloud-import-jobs \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "cloudConnectionId": "e2b03444-8c5d-44ed-bd9f-7eee882bdf81",
    "selector": {
      "type": "BY_IDS",
      "cloudObjectIds": [
        "string"
      ]
    },
    "keepFolderStructure": true,
    "destinationPath": "path/to/folder",
    "pathMappings": [
      {
        "matchPrefix": "path/to/folder",
        "removePrefix": "path/to/",
        "addPrefix": "new-folder/"
      }
    ]
  }'

Responses

Success

Bodyapplication/json
resultanyrequired
permittedActionsArray of objectsrequired
Response
{
  "result": {
    "id": "be161977-d44e-4888-af3c-66522e223963",
    "accountId": "cfb665ca-ce35-4418-b9d5-70ee815db4bd",
    "creatorId": "google-oauth2|110955770826801837334",
    "type": "IN_PROGRESS",
    "progress": { … },
    "status": "PENDING"
  },
  "permittedActions": [
    { … }
  ]
}