Sign in

v1

latestOpenAPI 3.1.02026-08-04118425322.0 KB
datasets > dataset

Create Dataset

Create a new dataset

post/api/v1/datasets

Headers

Authorizationstring required

Bearer authentication

Request body

namestring required

Name of the dataset, must be unique per organization and must only contain alphanumeric and underscore characters.

encoder_name'multimodal' | 'multimodal-tx-large2' | 'multimodal-tx-large3' | 'multimodal-tx-large4' | 'nova2-multimodal' | 'resnet-50' | 'resnet-50-reduced' required
descriptionstring nullable

A short summary of what the dataset includes or is intended for.

allowed_asset_typesDatasetsAssetTypeEnum[]

Types of assets allowed in this dataset.

keyframe_sampling_method'intelligent' | 'uniform'

Indicates the method used to sample keyframes from a video

keyframe_uniform_fps_sampling_ratenumber double nullable

If using uniform sampling method, number of keyframes/sec to sample from videos (allowed values: ≥ .00001 to 5 fps).

store_originalboolean

Whether to store original files.

store_previewboolean

Whether to store preview versions.

metadata_fields_to_indexstring[] nullable

The metadata fields to index for the dataset.

metadata_fields_to_embedstring[] nullable

The metadata fields to embed for the dataset.

Response

Successful Response

created_dtstring date-time required

The created datetime of the resource in ISO 8601 format.

updated_dtstring date-time nullable

The datetime the resource was last updated in ISO 8601 format.

created_bystring required

ID of the user who added the asset to the dataset.

updated_bystring nullable

ID of the user who last updated the asset.

deleted_dtstring date-time nullable

Timestamp if the resource was deleted.

deleted_bystring nullable

ID of the user who deleted the resource.

idstring uuid required

The unique identifier for the dataset.

namestring required

Name of the dataset, must be unique per organization and must only contain alphanumeric and underscore characters.

descriptionstring nullable required

A short summary of what the dataset includes or is intended for.

allowed_asset_typesDatasetsAssetTypeEnum[] required

Types of assets allowed in this dataset.

status'active' | 'inactive' | 'deleting' | 'deleted' required

Indicates the operational status of a dataset

keyframe_sampling_method'intelligent' | 'uniform' required

Indicates the method used to sample keyframes from a video

keyframe_uniform_fps_sampling_ratenumber double nullable

FPS rate used for uniform sampling.

store_originalboolean required

Whether the original file is stored.

store_previewboolean required

Whether preview files are stored.

metadata_fields_to_indexstring[] nullable

The metadata fields to index for the dataset.

metadata_fields_to_embedstring[] nullable

The metadata fields to embed for the dataset.