Skip to main content
POST
/
api
/
datasetrw
/
v1
/
datasets
Create a dataset
curl --request POST \
  --url https://api.example.com/api/datasetrw/v1/datasets \
  --header 'Content-Type: application/json' \
  --header 'X-Domino-Api-Key: <api-key>' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "grants": [
    {
      "targetId": "<string>"
    }
  ],
  "projectId": "<string>",
  "snapshotId": "<string>"
}
'
{
  "dataset": {
    "createdAt": "2022-03-12T02:13:44.467Z",
    "id": "62313ce67a0af0281c01a6a5",
    "name": "My Dataset",
    "snapshotIds": [
      "<string>"
    ],
    "tags": {},
    "description": "<string>",
    "projectId": "62313ce67a0af0281c01a6a5"
  },
  "metadata": {
    "notices": [
      "<string>"
    ],
    "requestId": "<string>"
  }
}

Authorizations

​
X-Domino-Api-Key
string
header
required

Body

application/json

Dataset to create

​
name
string
required

Name of this dataset. The name must be unique in the same project

​
description
string

Description of the dataset

​
grants
object[]

Permission grants to be assigned for this newly created dataset. Note that permissions can be edited after creation. If snapshotId is passed in, this parameter won't have any effect and caller will be assigned dataset Ownership.

​
projectId
string

ID of the project this dataset belongs to. Either projectId or snapshotId must be provided

​
snapshotId
string

ID of an existing snapshot to create a new dataset from. Either snapshotId or projectId must be provided.

Response

Success

​
dataset
object
required
​
metadata
object
required