---
title: "Attach an evaluator to a dataset"
method: POST
path: "/v1/datasets-v2/{datasetId}/evaluators"
tags: ["Datasets v2"]
---

# Attach an evaluator to a dataset

`POST /v1/datasets-v2/{datasetId}/evaluators`

## Request

- Base URL: `https://api.lunary.ai`
- URL: `https://api.lunary.ai/v1/datasets-v2/{datasetId}/evaluators`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lunary/apis/lunary-api/docs/v1/datasets-v2/:datasetId/evaluators/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `datasetId` string, uuid, required

## Request body

- object
  - `evaluatorId` string, uuid, required

## Response `200`

Updated dataset including evaluator slots

- DatasetV2WithItems
  - `id` string, uuid
  - `projectId` string, uuid
  - `ownerId` string, uuid, nullable
  - `ownerName` string, nullable
  - `ownerEmail` string, nullable
  - `name` string
  - `description` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `itemCount` integer
  - `currentVersionId` string, uuid, nullable
  - `currentVersionNumber` integer
  - `currentVersionCreatedAt` string, date-time, nullable
  - `currentVersionCreatedBy` string, uuid, nullable
  - `currentVersionRestoredFromVersionId` string, uuid, nullable
  - `evaluatorSlot1Id` string, uuid, nullable
  - `evaluatorSlot2Id` string, uuid, nullable
  - `evaluatorSlot3Id` string, uuid, nullable
  - `evaluatorSlot4Id` string, uuid, nullable
  - `evaluatorSlot5Id` string, uuid, nullable
  - `items` DatasetV2Item[]
    - `id` string, uuid
    - `datasetId` string, uuid
    - `input` string
    - `groundTruth` string, nullable
    - `output` string, nullable
    - `evaluatorResult1` object, nullable
    - `evaluatorResult2` object, nullable
    - `evaluatorResult3` object, nullable
    - `evaluatorResult4` object, nullable
    - `evaluatorResult5` object, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

---

[API](https://skmtc.dev/lunary/apis/lunary-api.md) - [All operations](https://skmtc.dev/lunary/apis/lunary-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lunary/apis/lunary-api/revisions/a38233713bdc?raw)