Skip to main content
POST
/
api
/
datasets
/
cURL
curl --request POST \
  --url https://{server}/api/datasets/ \
  --header 'Content-Type: application/json' \
  --cookie sessionid= \
  --data '
{
  "name": "<string>",
  "asset_content_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "",
  "owner_project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "creator": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "versions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "dataset": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "version_number": 123,
      "asset_content": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "description": "<string>",
  "owner_user": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "owner_project": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

sessionid
string
cookie
required

Body

POST /datasets/ — create a Dataset and its first DatasetVersion from an existing AssetContent.

The Dataset is owned by the caller by default. Pass owner_project_id to create a project-owned Dataset instead (the caller must be a member of that project); the view enforces ownership and resolves the user owner implicitly.

name
string
required
Maximum string length: 255
asset_content_id
string<uuid>
required
description
string
default:""
Maximum string length: 4096
owner_project_id
string<uuid> | null

Response

200 - application/json
id
string<uuid>
required
read-only
name
string
required
Maximum string length: 255
creator
string<uuid>
required
read-only
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
versions
object[]
required
read-only
description
string
owner_user
string<uuid> | null
owner_project
string<uuid> | null