Imports

Register locally stored data to Darwin

Changed on Nov 3, 2026

Register locally stored data with Darwin for upload. The request response will contain an upload ID for each item. After this step, the upload needs to be signed, the upload URL from this response used, and the upload confirmed.

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

Request

Base URL
https://darwin.v7labs.com
URL
https://darwin.v7labs.com/api/v2/teams/{team_slug}/items/register_upload
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

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",
          "tags": [
            "tag_class_name1",
            "tag_class_name2"
          ]
        }
      ],
      "tags": [
        "tag_class_name1",
        "tag_class_name2"
      ]
    }
  ]
}

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