Skip to content

Create dataset

POST
/datasets
object
teamId
required

ID of the team that will own this dataset

string
name
required

Human-readable name for the dataset (1-255 characters)

string
>= 1 characters <= 255 characters
description

Optional description of the dataset contents and purpose

string
tags

Optional tags for categorizing and filtering datasets

Array<string>
metadata

Optional key-value metadata for custom extensions

object
key
additional properties
nullable

Dataset created successfully

object
datasetId
required

Unique identifier for the dataset (nanoid format)

string
teamId
required

ID of the team that owns this dataset

string
name
required

Human-readable name for the dataset

string
description
required

Optional description of the dataset contents and purpose

string
nullable
tags
required

Tags for categorizing and filtering datasets

Array<string>
metadata
required

Arbitrary key-value metadata for custom extensions

object
key
additional properties
nullable
managed
required

Whether this dataset is system-managed (true) or user-created (false)

boolean
createdAt
required

ISO 8601 timestamp when the dataset was created

string format: date-time
updatedAt
required

ISO 8601 timestamp when the dataset was last modified

string format: date-time

Bad Request - Validation error or invalid input

object
error
required
string
code
string
details
nullable
retryable
boolean

Unauthorized - Authentication required or invalid token

object
error
required
string
code
string
details
nullable
retryable
boolean

Forbidden - Insufficient permissions

object
error
required
string
code
string
details
nullable
retryable
boolean

Conflict - Resource already exists or operation conflicts with current state

object
error
required
string
code
string
details
nullable
retryable
boolean