---
updatedAt: 2025-09-22T20:32:20.000Z
agentTools:
  projectIndex: https://docs.v7labs.com/llms.txt
---

# Import Visual Data from your Cloud External Storage via HTTP

```curl cURL
curl --request POST \
     --url https://darwin.v7labs.com/api/v2/teams/team_slug/items/register_existing \
     --header 'Accept: application/json' \
     --header 'Authorization: ApiKey $API_KEY' \
     --header 'Content-Type: application/json' \
     --data '
{
     "items": [
          {
               "path": "/",
               "slots": [
                    {
                         "as_frames": "false",
                         "slot_name": "1",
                         "storage_key": "filepath/my_image.jpg",
                         "file_name": "my_image.jpg"
                    }
               ],
               "name": "item"
          }
     ],
     "dataset_slug": "my-dataset",
     "storage_slug": "my-storage-bucket"
}
'

curl --request POST \
     --url https://darwin.v7labs.com/api/v2/teams/my-team/items/register_existing_readonly \
     --header 'Accept: application/json' \
     --header 'Authorization: ApiKey $API_KEY' \
     --header 'Content-Type: application/json' \
     --data '
{
     "items": [
          {
               "path": "/",
               "slots": [
                    {
                         "as_frames": "false",
                         "slot_name": "1",
                         "storage_key": "filepath/my_image.jpg",
                         "file_name": "my_image.jpg",
                         "storage_thumbnail_key": "thumbnail_path/thumbnail.jpg"
                    }
               ],
               "name": "item"
          }
     ],
     "dataset_slug": "my-dataset",
     "storage_slug": "my-storage-bucket"
}
'
```

```json Response Example
{"success":true}
```

# Data Registration

<!-- curl@1-25 -->

List the items (files) to be pushed to Darwin.

Used to register readwrite access items.

# Readonly External Storage Data Registration

<!-- curl@27-52 -->

If the access level for your External Storage is set to readonly, you need to make sure to attach all the necessary extra information to your request's body payload.