---
title: "Eval Sets Retrieve"
method: GET
path: "/evaluations/eval-sets/{id}/"
tags: ["evaluations"]
---

# Eval Sets Retrieve

`GET /evaluations/eval-sets/{id}/`

Retrieve, update, and delete a dataset

Endpoints:
    GET /api/datasets/{dataset_id}/
    PATCH /api/datasets/{dataset_id}/
    DELETE /api/datasets/{dataset_id}/

Superadmin: Can READ any dataset across all organizations via JWT.
            Cannot WRITE via JWT - must use API key for write operations.
Regular users: Can only access datasets in their organization.

Defense-in-depth:

Args (PATCH):
    - name (Optional): string
    - description (Optional): string

Returns (GET 200):
    {
      "id": "dataset_id",
      "name": "Support Conversations - July",
      "type": "sampling",
      "description": "Sampled support chats for July",
      "created_at": "2025-07-26T00:00:00Z",
      "updated_at": "2025-07-27T08:10:00Z",
      "organization": 123,
      "initial_log_filters": {"status_code": {"operator": "eq", "value": 200}},
      "unique_organization_ids": [],
      "timestamps": [],
      "log_count": 250,
      "evaluator": null,
      "status": "ready",
      "running_status": "pending",
      "running_progress": 0,
      "running_at": null,
      "completed_annotation_count": 0
    }

Returns (PATCH 200): Same shape as GET with updated fields
Returns (DELETE 204): No content

Defense-in-depth: SuperAdminMixin provides queryset routing + object-level ownership.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

- DatasetDetail
  - `id` string, required
  - `completed_annotation_count` integer, required
  - `updated_by` Editor, required
    - `id` integer, required
    - `email` string, required
    - `name` string, required
    - `username` string
    - `first_name` string
    - `last_name` string
  - `initial_log_filters` FilterParamDictPydantic — Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters. Each key is a metric name (str), and each value can be: - A single MetricFilterParamPydantic (one condition) - A List[MetricFilterParamPydantic] (multiple conditions for same metric) - A FilterBundlePydantic (nested filter bundle with connector) Note: Uses extra="allow" for dynamic metric name fields. The __pydantic_extra__ annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.
  - `tags` GenericTagDisplay[], required
    - `id` string, required
    - `name` string, required
    - `color` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `project` string, nullable
  - `name` string, required
  - `type` 'llm' | 'human' | 'dataset' | 'sampling' | 'reference' — * `llm` - Llm * `human` - Human * `dataset` - Dataset * `sampling` - Sampling * `reference` - Reference
  - `granularity` 'logs' | 'traces' | 'threads', required — * `logs` - Logs * `traces` - Traces * `threads` - Threads
  - `description` string
  - `created_at` string, date-time, required
  - `running_progress` number, double
  - `running_status` 'draft' | 'pending' | 'paused' | 'running' | 'waiting_for_annotations' | 'completed' | 'failed' — * `draft` - Draft * `pending` - Pending * `paused` - Paused * `running` - Running * `waiting_for_annotations` - Waiting For Annotations * `completed` - Completed * `failed` - Failed
  - `running_at` string, date-time, nullable
  - `updated_at` string, date-time, required
  - `unique_organization_ids` string[]
  - `timestamps` string[]
  - `log_count` integer, required
  - `ingest_workflow_id` string, nullable
  - `status` 'initializing' | 'ready' | 'failed' | 'loading', required — * `initializing` - Initializing * `ready` - Ready * `failed` - Failed * `loading` - Loading
  - `starred` boolean
  - `organization` integer, required
  - `evaluator` string, nullable

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)