---
title: "Api Annotation Items Retrieve"
method: GET
path: "/api/annotation-items/{id}/"
tags: ["evaluations"]
---

# Api Annotation Items Retrieve

`GET /api/annotation-items/{id}/`

GET/PATCH/DELETE /api/annotation-items/{id}/

Retrieve, update, or delete a specific annotation item (RUD from CRUD).

Permission (via ObjectOwnershipMixin config in SuperAdminMixin):
- Worker (assignee): Can GET/PATCH their OWN assigned items (status only)
- Org Admin: Can GET/PATCH/DELETE any item in org (can re-assign)
- Superadmin: Can access all items across all orgs

GET: Returns full item details with all fields
PATCH:
  - Worker: Update status, completed_at
  - Admin: Also update assignee_id (re-assign)
DELETE: Delete item (admin only via ownership check)

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

- AnnotationItemDetail — Detail serializer (same as base - both have full_object). Used for: GET /api/annotation-items/{id}/
  - `id` string, required
  - `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
  - `project` string, nullable
  - `source_id` string, required
  - `source_type` 'logs' | 'dataset_logs' | 'threads', required — * `logs` - Logs * `dataset_logs` - Dataset Logs * `threads` - Threads
  - `source_dataset_id` string, nullable, required
  - `evaluator_ids` string[], required — List of evaluator IDs that define which scoring criteria the assignee should fill out
  - `status` 'pending' | 'processing' | 'paused' | 'completed' | 'failed' | 'cancelled' — * `pending` - Pending * `processing` - Processing * `paused` - Paused * `completed` - Completed * `failed` - Failed * `cancelled` - Cancelled
  - `full_object` unknown, required
  - `created_at` string, date-time, required
  - `completed_at` string, date-time, nullable
  - `updated_at` string, date-time, required
  - `organization` integer, required

---

[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)