---
title: "Annotation Queue Item Progress Update"
method: POST
path: "/annotation_queues/{queue_id}/items/{item_id}/progress"
tags: ["Annotation Queues"]
---

# Annotation Queue Item Progress Update

`POST /annotation_queues/{queue_id}/items/{item_id}/progress`

## Request

- Base URL: `https://trace.wandb.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://trace.wandb.ai/annotation_queues/{queue_id}/items/{item_id}/progress`
- Auth: none declared

Update the annotation state of a queue item for the current annotator.

## Path parameters

- `queue_id` string, required
- `item_id` string, required

## Request body

- AnnotationQueueItemProgressUpdateBody: Request body for updating annotation progress (queue_id and item_id come from path). Note: wb_user_id is not included in the body - it's set server-side from the authenticated session.
  - `project_id` string, required
  - `annotation_state` string, required: New state: 'in_progress', 'completed', or 'skipped'

## Response `200`

Successful Response

- AnnotatorQueueItemsProgressUpdateRes: Response from updating annotation state.
  - `item` AnnotationQueueItemSchema, required: Schema for annotation queue item responses.
    - `id` string, required
    - `project_id` string, required
    - `queue_id` string, required
    - `call_id` string, required
    - `call_started_at` string, date-time, required
    - `call_ended_at` string, date-time, nullable
    - `call_op_name` string, required
    - `call_trace_id` string, required
    - `display_fields` string[], required
    - `added_by` string, nullable
    - `annotation_state` 'unstarted' | 'in_progress' | 'completed' | 'skipped', required
    - `annotator_user_id` string, nullable
    - `created_at` string, date-time, required
    - `created_by` string, required
    - `updated_at` string, date-time, required
    - `deleted_at` string, date-time, nullable
    - `position_in_queue` integer, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `dd89fadfe4e4`: 3 info
  - the endpoint scheme security `HTTPBasic` was removed from the API
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-01-29** `13059f956116`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/changes/annotation_queues/:queue_id/items/:item_id/progress/post.md)

---

[API](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api.md) - [All operations](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/revisions/f7643c49bf2e?raw)