Skip to main content
POST
Create a dataset

Authorizations

Authorization
string
header
required

Enter Gentrace API key (Format: Authorization: Bearer )

Body

application/json
name
string
required

Dataset name

Example:

"Dataset - negative user feedback - 2025-04-01"

description
string | null
required

Dataset description

Example:

"Negative user feedback collected from our production environment"

isGolden
boolean

Whether the dataset is golden

Example:

false

pipelineSlug
string

Pipeline slug (mutually exclusive with pipelineId)

Example:

"email-summarizer"

pipelineId
string<uuid>

Pipeline ID (mutually exclusive with pipelineSlug)

Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

Successful response

id
string<uuid>
required

Dataset UUID

Example:

"123e4567-e89b-12d3-a456-426614174000"

createdAt
string
required

Creation timestamp (ISO 8601)

Example:

"2025-04-01T00:00:00.000Z"

updatedAt
string
required

Last update timestamp (ISO 8601)

Example:

"2025-04-01T00:00:00.000Z"

name
string
required

Dataset name

Example:

"Dataset - negative user feedback - 2025-04-01"

description
string | null
required

Dataset description

Example:

"Negative user feedback collected from our production environment"

archivedAt
string | null
required

Archive timestamp (ISO 8601)

Example:

"2025-04-01T00:00:00.000Z"

pipelineId
string
required

Pipeline UUID

Example:

"123e4567-e89b-12d3-a456-426614174000"