Datasets

Copies an accessible dataset, or selected splits, a saved version, or selected images of it, into your workspace or into a dataset you own.

post/api/datasets/{owner}/{dataset}/clone

Request

  • Base URL
    https://platform.ultralytics.com
  • Auth
    HTTP bearer

Path parameters

ownerstring required
Example:ultralytics

Dataset owner

datasetstring required
Example:coco8

Dataset name

Request body

namestring
datasetstring

Name for the cloned dataset

descriptionstring
visibility'public' | 'private'

Resource visibility

license'None' | 'CC0-1.0' | 'PDM-1.0' | 'CC-BY-2.5' | 'CC-BY-3.0' | 'CC-BY-4.0' | 'CC-BY-NC-2.0' | 'CC-BY-NC-3.0' | 'CC-BY-NC-4.0' | 'CC-BY-SA-3.0' | 'CC-BY-SA-4.0' | 'CC-BY-NC-SA-3.0' | 'CC-BY-NC-SA-4.0' | 'CC-BY-ND-4.0' | 'CC-BY-NC-ND-2.0' | 'CC-BY-NC-ND-4.0' | 'Apache-2.0' | 'MIT' | 'BSD-3-Clause' | 'AGPL-3.0' | 'GPL-2.0' | 'GPL-3.0' | 'LGPL-3.0' | 'ODbL-1.0' | 'DbCL-1.0' | 'Research-Only' | 'Other'

Dataset license identifier

ownerstring

Destination owner

splitsstring[]

Live splits to clone; defaults to all

versioninteger

Saved version to clone instead of live images

imageIdsstring[]

Clone only these live images

annotationsboolean

Copy annotations with the images; false clones raw images only

intostring

Merge unlabeled into this dataset you own instead

Example request

{
  "owner": "ultralytics",
  "imageIds": [
    "507f1f77bcf86cd799439011"
  ]
}

Response

Dataset cloned

idstring required
ownerstring required
datasetstring required
namestring required
imageCountinteger required
classCountinteger
region'us' | 'eu' | 'ap' required

Data region where data is stored

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property