> ## Documentation Index > Fetch the complete documentation index at: https://docs.veri.studio/llms.txt > Use this file to discover all available pages before exploring further. # Add items to an annotation queue > Adds explicit targets (each checked like a score target: a foreign or missing one is a 404 and nothing is added) or the targets of matching scores (`from_scores`). A thread target pins its revision to the thread's latest request. Targets already in the queue are counted, not added again. A queue holds at most 10,000 open items. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/annotation-queues/{id_or_name}/items openapi: 3.1.0 info: title: Veri API description: >- REST API for the Veri RL post-training platform. All requests require a Bearer API key (`vk_` prefix). license: name: '' version: 0.1.0 servers: - url: https://api.veri.studio description: Production security: [] tags: - name: Training jobs description: Create, monitor, and manage training jobs. - name: Datasets description: Upload and connect training datasets. - name: Deployments description: Serve trained models and run inference. - name: Volumes description: Persistent file storage mounted into jobs. - name: Models description: Custom model registry deployments serve from. - name: Regions description: Discover available launch regions. - name: GPU description: Live GPU availability by provider and region. - name: Code artifacts description: Upload custom training script bundles. - name: Billing description: Credit balance and transaction history. - name: API keys description: Create and revoke API keys. - name: Account description: The authenticated caller's identity. - name: Settings description: Account-level integrations (Weights & Biases). - name: Metrics description: Prometheus metrics export for your own observability stack. - name: Evaluators description: 'Evaluators: versioned scoring rules (LLM judge, code, human).' - name: Experiments description: >- Experiments: offline runs of a pinned dataset snapshot through a target, scored by pinned evaluators. - name: Annotation queues description: >- Human review: queue traces, threads and experiment items, reserve one at a time, score them and feed corrections back into datasets. - name: Monitors description: >- Monitors: evaluators scoring a sampled share of a deployment's live traffic. - name: Observability description: Agent conversations, agents and their traffic. - name: Public runs description: Unauthenticated reads of runs their owners published to Explore. paths: /v1/annotation-queues/{id_or_name}/items: post: tags: - Annotation queues summary: Add items to an annotation queue description: >- Adds explicit targets (each checked like a score target: a foreign or missing one is a 404 and nothing is added) or the targets of matching scores (`from_scores`). A thread target pins its revision to the thread's latest request. Targets already in the queue are counted, not added again. A queue holds at most 10,000 open items. operationId: add_items parameters: - name: id_or_name in: path description: Queue id (aq_...) or name required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ItemsAddRequest' required: true responses: '200': description: Added and already-present counts content: application/json: schema: $ref: '#/components/schemas/ItemsAddResponse' '400': description: Bad target shape or filter, or evals disabled '404': description: A target, evaluator or the queue is not in the caller's workspace '409': description: >- queue_full; the queue is archived; or an experiment item has no output yet security: - bearerAuth: [] components: schemas: ItemsAddRequest: type: object description: |- Exactly one of `targets` (1-1000, all checked, all or nothing) or `from_scores`. properties: targets: type: - array - 'null' items: $ref: '#/components/schemas/ItemTarget' from_scores: oneOf: - type: 'null' - $ref: '#/components/schemas/FromScoresRequest' additionalProperties: false ItemsAddResponse: type: object required: - object - added - already_present - skipped - counts properties: object: type: string description: Always "annotation_item_batch". added: type: integer format: int64 already_present: type: integer format: int64 description: Targets already in the queue (or repeated in the request). skipped: type: integer format: int64 description: |- from_scores only: matching targets that no longer resolve (e.g. a purged request) or don't fit the queue's evaluators. counts: $ref: '#/components/schemas/QueueCounts' description: The queue's counts after the add. ItemTarget: type: object description: |- One target, shaped by the queue's target_type: trace {request_id}; thread {deployment_id, thread_id, target_revision?} (default: the thread's latest request, pinned when added); experiment_item {experiment_id, item_id}. Fields of other target types are refused. properties: request_id: type: - string - 'null' deployment_id: type: - string - 'null' thread_id: type: - string - 'null' target_revision: type: - string - 'null' experiment_id: type: - string - 'null' item_id: type: - string - 'null' additionalProperties: false FromScoresRequest: type: object description: |- Add the targets of the workspace's ok scores from one evaluator that match every given filter, newest score first. required: - evaluator properties: evaluator: type: string description: Evaluator id or name. evaluator_version: type: - integer - 'null' format: int32 passed: type: - boolean - 'null' description: Only scores with this verdict. min: type: - number - 'null' format: double description: 'Numeric scores only: value >= min / value <= max.' max: type: - number - 'null' format: double deployment_id: type: - string - 'null' description: 'Trace and thread queues: one deployment''s traffic.' experiment_id: type: - string - 'null' description: 'Experiment-item queues: one experiment''s items.' from: type: - string - 'null' format: date-time description: Scores created at or after / before (RFC 3339). to: type: - string - 'null' format: date-time limit: type: - integer - 'null' format: int64 description: 1-1000 (default 100). additionalProperties: false QueueCounts: type: object description: Items per effective status. An expired reservation counts as pending. required: - pending - reserved - completed - skipped properties: pending: type: integer format: int64 reserved: type: integer format: int64 completed: type: integer format: int64 skipped: type: integer format: int64 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API key description: API key with the `vk_` prefix. Create one from the dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.