Skip to main content
POST
/
v4
/
datasets
Create a dataset
curl --request POST \
  --url https://gentrace.ai/api/v4/datasets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Dataset - negative user feedback - 2025-04-01",
  "description": "Negative user feedback collected from our production environment",
  "isGolden": false,
  "pipelineSlug": "email-summarizer",
  "pipelineId": "123e4567-e89b-12d3-a456-426614174000"
}'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-04-01T00:00:00.000Z",
  "updatedAt": "2025-04-01T00:00:00.000Z",
  "name": "Dataset - negative user feedback - 2025-04-01",
  "description": "Negative user feedback collected from our production environment",
  "archivedAt": "2025-04-01T00:00:00.000Z",
  "pipelineId": "123e4567-e89b-12d3-a456-426614174000"
}

Authorizations

​
Authorization
string
header
required

Enter Gentrace API key (Format: Authorization: Bearer <token>)

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"