Dataset Items

get

Retrieves multiple dataset items.

Query parameters

datasetIdstringRequired

pageNumbernumber · min: 1Optional

The page number.

Default: 1

pageSizenumber · min: 1 · max: 100Optional

The page size.

Default: 10

searchstring · min: 1Optional

Search term to filter dataset items by name or description.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves all dataset items for the workspace.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

updatedAtstring · date-timeRequired

datasetIdstring · uuidRequired

The dataset ID associated with the dataset item.

descriptionstring · min: 3 · max: 250Required

The internal description of the dataset item.

filestringRequired

The file payload or file reference associated with the dataset item.

namestring · min: 3 · max: 50Required

The display name of the dataset item.

statusstring · enumRequired

The processing status of the dataset item.

Possible values:

401

Unauthorized.

application/json

get/api/v1/dataset-items

GET /api/v1/dataset-items?datasetId=text HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

[
  {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "datasetId": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "file": "text",
    "name": "text",
    "status": "pending"
  }
]

post

Creates a new dataset item.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

datasetIdstring · uuidRequired

The dataset ID associated with the dataset item.

filestringRequired

A base64 encoded string with prefix.

Pattern: ^data:.*;base64,

namestring · min: 3 · max: 50Optional

The display name of the dataset item. Required when preserveName is true; ignored otherwise.

preserveNamebooleanOptional

When true, stores the provided name instead of generating a title from the document content.

Responses

200

The dataset item was created.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

updatedAtstring · date-timeRequired

datasetIdstring · uuidRequired

The dataset ID associated with the dataset item.

descriptionstring · min: 3 · max: 250Required

The internal description of the dataset item.

filestringRequired

The file payload or file reference associated with the dataset item.

namestring · min: 3 · max: 50Required

The display name of the dataset item.

statusstring · enumRequired

The processing status of the dataset item.

Possible values:

400

Invalid dataset item configuration.

application/json

401

Unauthorized.

application/json

403

Plan limit exceeded.

application/json

404

Dataset not found.

application/json

post/api/v1/dataset-items

POST /api/v1/dataset-items HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 100

{
  "datasetId": "123e4567-e89b-12d3-a456-426614174000",
  "file": "text",
  "name": "text",
  "preserveName": true
}

{
  "createdAt": "2026-01-01T00:00:00.000Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "datasetId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "file": "text",
  "name": "text",
  "status": "pending"
}

get

Retrieves a dataset item.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves a dataset item.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

updatedAtstring · date-timeRequired

datasetIdstring · uuidRequired

The dataset ID associated with the dataset item.

descriptionstring · min: 3 · max: 250Required

The internal description of the dataset item.

filestringRequired

The file payload or file reference associated with the dataset item.

namestring · min: 3 · max: 50Required

The display name of the dataset item.

statusstring · enumRequired

The processing status of the dataset item.

Possible values:

contentstringRequired

401

Unauthorized.

application/json

404

Dataset item not found.

application/json

get/api/v1/dataset-items/{id}

GET /api/v1/dataset-items/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "createdAt": "2026-01-01T00:00:00.000Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "datasetId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "file": "text",
  "name": "text",
  "status": "pending",
  "content": "text"
}

delete

Removes a dataset item.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

The dataset item was removed.

application/json

messagestringRequired

An informative message for a call that has no effective result to be returned.

401

Unauthorized.

application/json

404

Dataset item not found.

application/json

delete/api/v1/dataset-items/{id}

DELETE /api/v1/dataset-items/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "message": "text"
}

patch

Updates a dataset item.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

descriptionstring · min: 3 · max: 250Optional

The internal description of the dataset item.

filestringOptional

The file payload or file reference associated with the dataset item.

namestring · min: 3 · max: 50Optional

The display name of the dataset item.

statusstring · enumOptional

The processing status of the dataset item.

Possible values:

contentstringOptional

Responses

200

The dataset item was updated.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

updatedAtstring · date-timeRequired

datasetIdstring · uuidRequired

The dataset ID associated with the dataset item.

descriptionstring · min: 3 · max: 250Required

The internal description of the dataset item.

filestringRequired

The file payload or file reference associated with the dataset item.

namestring · min: 3 · max: 50Required

The display name of the dataset item.

statusstring · enumRequired

The processing status of the dataset item.

Possible values:

400

Invalid dataset item configuration.

application/json

401

Unauthorized.

application/json

403

Plan limit exceeded.

application/json

404

The dataset item was not found.

application/json

patch/api/v1/dataset-items/{id}

PATCH /api/v1/dataset-items/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "description": "text",
  "file": "text",
  "name": "text",
  "status": "pending",
  "content": "text"
}

{
  "createdAt": "2026-01-01T00:00:00.000Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "datasetId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "file": "text",
  "name": "text",
  "status": "pending"
}