Imports

Register externally stored data in read-write

Changed on Nov 3, 2026

Send a request to register files stored in external storage with a Darwin dataset in read-write. This means Darwin will generate thumbnails and write them back to your storage in the location specified by your configuration's prefix.

Note: This operation is rate-limited to 100 requests per minute and can contain up to 100 items per request.

post/api/v2/teams/{team_slug}/items/register_existing

Request

Base URL
https://darwin.v7labs.com
URL
https://darwin.v7labs.com/api/v2/teams/{team_slug}/items/register_existing
Auth
- HTTP bearer
- or API key in header Authorization

Path parameters

team_slugstring required

Team's sluggified name

Request body

dataset_slugstring required

Dataset's slugified name

storage_slugstring required

Slugified name of the storage on which the slots reside.

Example request

{
  "dataset_slug": "my-dataset",
  "items": [
    {
      "layout": {
        "slots_grid": [
          [
            [
              "1",
              "2"
            ],
            "3"
          ],
          [
            "4"
          ]
        ],
        "version": 3
      },
      "name": "some-item",
      "slots": [
        {
          "file_name": "my_image.jpg",
          "slot_name": "0",
          "storage_key": "my/existing/file.jpg",
          "tags": [
            "tag_class_name1",
            "tag_class_name2"
          ]
        }
      ],
      "tags": [
        "tag_class_name1",
        "tag_class_name2"
      ]
    }
  ],
  "storage_slug": "my-storage-bucket"
}

Response

DatasetsV2.ItemRegistration.RegistrationResponse

Example response

{
  "blocked_items": [
    {
      "id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781",
      "name": "some-item",
      "slots": [
        {
          "file_name": "my_image.jpg",
          "size_bytes": 500,
          "slot_name": "0"
        }
      ]
    }
  ],
  "items": [
    {
      "id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781",
      "name": "some-item",
      "slots": [
        {
          "file_name": "my_image.jpg",
          "size_bytes": 500,
          "slot_name": "0",
          "upload_id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781"
        }
      ]
    }
  ]
}

Changes

Nov 3, 20269cd7289ca12b Revision changes
- warning
  added the new DUPLICATE_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new DUPLICATE_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new DUPLICATE_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new EXTERNAL_STORAGE_ACCESS_FAILED enum value to the / response property for the response status
- warning
  added the new EXTERNAL_STORAGE_ACCESS_FAILED enum value to the / response property for the response status
- warning
  added the new EXTERNAL_STORAGE_ACCESS_FAILED enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASONS enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASONS enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASONS enum value to the / response property for the response status
- warning
  added the new REJECT_REASON_REQUIRED enum value to the / response property for the response status
- warning
  added the new REJECT_REASON_REQUIRED enum value to the / response property for the response status
- warning
  added the new REJECT_REASON_REQUIRED enum value to the / response property for the response status
- warning
  added the new REPORT_TOO_LARGE enum value to the / response property for the response status
- warning
  added the new REPORT_TOO_LARGE enum value to the / response property for the response status
- warning
  added the new REPORT_TOO_LARGE enum value to the / response property for the response status
- warning
  added the new TOO_MANY_ACTIVE_REPORT_JOBS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_ACTIVE_REPORT_JOBS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_ACTIVE_REPORT_JOBS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_AI_REVIEW_BLUEPRINTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_AI_REVIEW_BLUEPRINTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_AI_REVIEW_BLUEPRINTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_EXPORTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_EXPORTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_EXPORTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_REJECT_REASONS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_REJECT_REASONS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_REJECT_REASONS enum value to the / response property for the response status

Operation history