Search documentation
karat

+

K

User Documentation ↗

Create Dataset

POST/api/v1/datasets

Creates a new Dataset. A default branch - master for most enrollments - will be created on the Dataset.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:datasets-write.

Request body

CreateDatasetRequest
object
Hide child attributes

Hide child attributes

name
string
parentFolderRid
string

Response body

Dataset
object
Hide child attributes

Hide child attributes

rid
string

The Resource Identifier (RID) of a Dataset.

name
string
parentFolderRid
string

Examples

Request

Copied!
1 2 3 4 5 curl -X POST \ -H "Content-type: application/json" \ -H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/v1/datasets" \ -d '{"name":"My Dataset","parentFolderRid":"ri.foundry.main.folder.bfe58487-4c56-4c58-aba7-25defd6163c4"}'

Response

Copied!
1 2 3 4 { "rid": "ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da", "path": "/Empyrean Airlines/My Important Project/My Dataset" }