ULultralytics
Datasets

Create a dataset

Changed on

Creates an empty dataset in your personal workspace or a team workspace. An existing slug is rejected with 409.

post/api/datasets

Request

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

Request body

datasetstring required

Dataset name used in Platform URLs

namestring required

Display name

descriptionstring
metadataobject

Custom JSON metadata with keys limited to 128 characters and at most 500,000 serialized characters.

visibility'public' | 'private'

Resource visibility

blurFacesboolean

Automatically blur faces in uploaded images

task'detect' | 'segment' | 'semantic' | 'depth' | 'classify' | 'pose' | 'obb'

Dataset task type

imageCountinteger
classNamesstring[]
format'yolo' | 'coco' | 'raw' | 'ndjson'

Dataset annotation format

tagsstring[]
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

Workspace owner

Example request

{
  "dataset": "coco8",
  "name": "COCO8",
  "owner": "ultralytics"
}

Response

Dataset created

idstring required

Created dataset ID

ownerstring required

Dataset owner

datasetstring required

Created dataset name used in Platform URLs

region'us' | 'eu' | 'ap' required

Data region where data is stored

Changes