v4

latestOpenAPI 3.1.02026-08-019681,1012.0 MB
scorer-feedback

Update Queue

Update a feedback queue by performing an action.

Supported actions:

  • "abort": Abort the feedback application process and return the queue to pending state. Used when user clicks "Back" or "Cancel" during generation or review. Clears draft_prompt and generation_task_id. Same queue is reused. Can be called during 'generating' or 'reviewing' state.

  • "complete": Complete the queue after saving a new scorer version. Used when user saves a new version from the review flow. Sets status to completed (immutable) and links queue to the resulting version. Requires target_scorer_version_id, result_scorer_id, and result_scorer_version_id. Can only be called during 'reviewing' state.

Request body:

  • action: The action to perform ("abort" or "complete")
  • target_scorer_version_id: Required for "complete" action - ID of the version feedback was applied to
  • result_scorer_id: Required for "complete" action - ID of the scorer that owns the result version. For custom LLM scorers this is the same as the queue's scorer. For preset scorers this is the new custom scorer duplicated from the preset.
  • result_scorer_version_id: Required for "complete" action - ID of the scorer version created

Response:

  • 200 OK with queue details showing updated status

Errors:

  • 404 - Queue not found or user doesn't have access
  • 409 - Queue is not in a valid state for the requested action
  • 422 - Invalid action or missing required parameters
patch/feedback-queues/{queue_id}

Path parameters

queue_idstring uuid required

Request body

action'abort' | 'complete' required

Actions that can be performed on a feedback queue.

target_scorer_version_idstring uuid4 nullable

Required for 'complete' action: ID of the scorer version that feedback was applied to

result_scorer_idstring uuid4 nullable

Required for 'complete' action: ID of the scorer that owns the result version. For custom LLM scorers this is the same scorer. For preset scorers this is the new custom scorer.

result_scorer_version_idstring uuid4 nullable

Required for 'complete' action: ID of the scorer version created from this queue's feedback

Response

Successful Response

queue_idstring uuid4 required

Queue ID that was updated

scorer_idstring uuid4 required

Scorer ID

target_scorer_version_idstring uuid4 required

Target scorer version for the queue

result_scorer_idstring uuid4 nullable

Scorer that owns the result version (set on complete)

result_scorer_version_idstring uuid4 nullable

Scorer version created from this queue (set on complete)

statusstring required

Current queue status after update

messagestring required

Confirmation message