한국어

datasets

datasets API, 23 endpoints (generated)

데이터셋 매니페스트: 카탈로그, 샘플 미리보기, 계보(lineage) 사용 현황 및 수집(ingest).

GET /api/v1/datasets

GET/api/v1/datasets

데이터셋 목록

호출자 테넌트의 카탈로그 데이터셋 조회 (화면 9).

Permission: VIEW

Parameters

NameInTypeRequiredDescription
sourcequerystring?
statusquerystring?
external_sourcequerystring?이 외부 소스에 연결된 데이터셋만 (소스 id)
pagequeryinteger
page_sizequeryinteger?
qquerystring?이름 부분 일치 검색
sortquerystring?정렬 키
orderquerystringasc | desc

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets

POST/api/v1/datasets

데이터셋 수집

DataOps가 전달한 데이터셋 매니페스트 수집.

Permission: DATASET_WRITE

Request body: application/json, DatasetCreate

FieldTypeRequiredDescription
idstring✓Id
namestring✓Name
sourcestring?Source
schema_versionstring?Schema Version
record_countinteger?Record Count
size_bytesinteger?Size Bytes
formatstring?Format
key_fieldsobject[]Key Fields
storage_uristring?Storage Uri
validation_statusstringValidation Status
validationValidationBody?
variablesVariableBody[]Variables

Responses

StatusDescription
201Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}

GET/api/v1/datasets/{dataset_id}

데이터셋 매니페스트 상세

단일 데이터셋의 전체 매니페스트 상세 반환.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

PATCH /api/v1/datasets/{dataset_id}

PATCH/api/v1/datasets/{dataset_id}

데이터셋 정보 수정

데이터셋의 이름·소스·모달리티·PLY 라벨 매핑을 고침 (D-9, ).

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓

Request body: application/json, DatasetUpdate

FieldTypeRequiredDescription
namestring?Name
sourcestring?Source
modalitystring?Modality
pointcloud_labelsPointcloudLabels?
pointcloud_class_renameobject?Pointcloud Class Rename
pointcloud_class_unassignbooleanPointcloud Class Unassign

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/datasets/{dataset_id}

DELETE/api/v1/datasets/{dataset_id}

데이터셋 삭제

데이터셋과 업로드된 파일 전체 삭제.

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
forcequeryboolean

Responses

StatusDescription
204Successful Response
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/sample

GET/api/v1/datasets/{dataset_id}/sample

샘플 미리보기

오브젝트 스토리지에서 데이터셋 행의 샘플 미리보기를 온디맨드로 제공.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
limitqueryinteger

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/usage

GET/api/v1/datasets/{dataset_id}/usage

데이터셋 사용 이력

이 데이터셋을 사용한 학습 실행(run) 조회.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/drafts

POST/api/v1/datasets/drafts

데이터셋 생성

정보(이름/모달리티/소스)만으로 데이터셋을 즉시 생성.

Permission: DATASET_WRITE

Request body: application/json, DraftCreate

FieldTypeRequiredDescription
namestring✓Name
modalitystring?Modality
sourcestring?Source

Responses

StatusDescription
201Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/files

GET/api/v1/datasets/{dataset_id}/files

파일 목록

데이터셋의 업로드 파일 목록 반환.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
statusquerystring?
kindquerystring?파일 종류 (image 등)
originquerystring?upload | sync
pagequeryinteger
page_sizequeryinteger?
qquerystring?이름 부분 일치 검색
sortquerystring?정렬 키
orderquerystringasc | desc

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/files

POST/api/v1/datasets/{dataset_id}/files

파일 업로드

데이터셋에 파일 1개를 multipart로 업로드.

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓

Request body: multipart/form-data, Body_upload_file_api_v1_datasets__dataset_id__files_post

FieldTypeRequiredDescription
filestring✓File

Responses

StatusDescription
201Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/archive

POST/api/v1/datasets/{dataset_id}/archive

ZIP 아카이브 업로드

데이터셋에 ZIP 아카이브 1개를 올려 멤버별 파일로 풀어 저장.

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓

Request body: multipart/form-data, Body_upload_archive_api_v1_datasets__dataset_id__archive_post

FieldTypeRequiredDescription
filestring✓File

Responses

StatusDescription
201Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/uploads

POST/api/v1/datasets/{dataset_id}/uploads

청크 업로드 세션 시작

파일 1개 또는 ZIP 1개를 청크로 나눠 올리는 세션 시작.

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓

Request body: application/json, DatasetUploadInit

FieldTypeRequiredDescription
filenamestring✓Filename
sizeinteger✓Size
sha256string?Sha256
chunk_sizeinteger?Chunk Size

Responses

StatusDescription
201Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/uploads/{upload_id}

GET/api/v1/datasets/{dataset_id}/uploads/{upload_id}

청크 업로드 상태(재개 지점)

받은 청크 인덱스 목록과 상태 반환.

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
upload_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

PUT /api/v1/datasets/{dataset_id}/uploads/{upload_id}/chunks/{index}

PUT/api/v1/datasets/{dataset_id}/uploads/{upload_id}/chunks/{index}

청크 전송

청크 하나 전송(application/octet-stream).

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
upload_idpathstring✓
indexpathinteger✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/uploads/{upload_id}:complete

POST/api/v1/datasets/{dataset_id}/uploads/{upload_id}:complete

청크 업로드 마감

모든 청크가 도착했음을 알리고 즉시 응답(202).

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
upload_idpathstring✓

Responses

StatusDescription
202Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/files/{file_id}

GET/api/v1/datasets/{dataset_id}/files/{file_id}

파일 상세

단일 업로드 파일의 상태/메타데이터 반환 (VIEW 권한).

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
file_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/datasets/{dataset_id}/files/{file_id}

DELETE/api/v1/datasets/{dataset_id}/files/{file_id}

파일 삭제

데이터셋에서 파일 삭제.

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
file_idpathstring✓
forcequeryboolean

Responses

StatusDescription
204Successful Response
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/files/{file_id}/content

GET/api/v1/datasets/{dataset_id}/files/{file_id}/content

파일 내용

파일 원본 또는 다운샘플 프리뷰 바이트 스트리밍.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
file_idpathstring✓
variantquerystring
downloadqueryboolean

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/revalidate-annotations

POST/api/v1/datasets/{dataset_id}/revalidate-annotations

어노테이션 매칭 재계산

어노테이션 파일들의 이미지 매칭률 재계산.

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/revalidate

POST/api/v1/datasets/{dataset_id}/revalidate

데이터셋 파일 재검증

데이터셋의 모든 파일을 저장소에서 다시 읽어 검증.

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

PUT /api/v1/datasets/{dataset_id}/files/{file_id}/instance-classes

PUT/api/v1/datasets/{dataset_id}/files/{file_id}/instance-classes

PLY 인스턴스에 클래스 할당

한 PLY 파일의 인스턴스마다 클래스 지정.

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
file_idpathstring (uuid)✓

Request body: application/json, object

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/instance-classes.csv

GET/api/v1/datasets/{dataset_id}/instance-classes.csv

PLY 인스턴스 할당 CSV 내보내기

검증된 PLY 의 모든 인스턴스를 한 행씩 내보냄.

Permission: VIEW

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/instance-classes.csv

POST/api/v1/datasets/{dataset_id}/instance-classes.csv

PLY 인스턴스 할당 CSV 반입

CSV 로 여러 파일의 인스턴스 할당을 한 번에 변경.

Permission: DATASET_WRITE

Parameters

NameInTypeRequiredDescription
dataset_idpathstring✓
dry_runqueryboolean

Request body: multipart/form-data, Body_import_instance_classes_api_v1_datasets__dataset_id__instance_classes_csv_post

FieldTypeRequiredDescription
filestring✓File

Responses

StatusDescription
200Successful Response (object)
422Validation Error (HTTPValidationError)

Written for the platform as of 2026-10-02.

© MLOps Central Platform