---
title: "Api Annotation Items List Update"
method: PUT
path: "/api/annotation-items/list/"
tags: ["evaluations"]
---

# Api Annotation Items List Update

`PUT /api/annotation-items/list/`

PUT handler with superadmin lock and field protection.

Same as patch() - checks lock and field protection before delegating.

## Headers

- `Authorization` string, required

## Request body

- AnnotationItemListRequest — Lightweight serializer for LIST view (admin management). Shows basic item info WITHOUT full_object (for table/overview display). Used for: /api/annotation-items/list/ (paginated, filterable admin view)
  - `id` string
  - `source_id` string, required
  - `source_type` 'logs' | 'dataset_logs' | 'threads', required — * `logs` - Logs * `dataset_logs` - Dataset Logs * `threads` - Threads
  - `source_dataset_id` string, nullable
  - `status` 'pending' | 'processing' | 'paused' | 'completed' | 'failed' | 'cancelled' — * `pending` - Pending * `processing` - Processing * `paused` - Paused * `completed` - Completed * `failed` - Failed * `cancelled` - Cancelled
  - `evaluator_ids` string[] — List of evaluator IDs that define which scoring criteria the assignee should fill out
  - `completed_at` string, date-time, nullable

## Response `200`

- AnnotationItemList — Lightweight serializer for LIST view (admin management). Shows basic item info WITHOUT full_object (for table/overview display). Used for: /api/annotation-items/list/ (paginated, filterable admin view)
  - `id` string
  - `source_id` string, required
  - `source_type` 'logs' | 'dataset_logs' | 'threads', required — * `logs` - Logs * `dataset_logs` - Dataset Logs * `threads` - Threads
  - `source_dataset_id` string, nullable
  - `assignee` Editor, required
    - `id` integer, required
    - `email` string, required
    - `name` string, required
    - `username` string
    - `first_name` string
    - `last_name` string
  - `created_by` Editor, required
    - `id` integer, required
    - `email` string, required
    - `name` string, required
    - `username` string
    - `first_name` string
    - `last_name` string
  - `status` 'pending' | 'processing' | 'paused' | 'completed' | 'failed' | 'cancelled' — * `pending` - Pending * `processing` - Processing * `paused` - Paused * `completed` - Completed * `failed` - Failed * `cancelled` - Cancelled
  - `evaluator_ids` string[] — List of evaluator IDs that define which scoring criteria the assignee should fill out
  - `created_at` string, date-time, required
  - `completed_at` string, date-time, 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)