Skip to main content
A Case is a single piece of work delivered into a Queue for an Agent to pick up. The CLI lets you inspect Case history, re-process Cases in bulk, manage labels, and view the Agents bound to a Queue. For an overview of the Queue system, see Queue.

Cases (duvo cases)

Inspect a Case’s history

Edit a Case

Update a Case’s title and/or its free-form data. Provide at least one field. Titles can be up to 500 characters.
Editing a Case works whether it is pending, in progress, or already settled. Status, priority, and labels have their own commands.

Bulk-reprocess Cases

Re-process 1–100 Cases on a specific Agent in one call.
Any active Runs for these Cases are interrupted.

Set Case priority

Raise or clear the priority of 1–100 Cases so higher-priority work is picked up first among eligible pending Cases. Priority levels are none (the default), medium, and high. Due postponed Cases are still picked up before priority ordering applies.
You can also set a priority when creating a Case, and filter the list by priority:

Filter by issue severity

When a Case evaluation flags failing rubrics, the Case records the highest severity it hit. Filter on it to triage the worst results first:
Severity narrows within evaluated Cases that found issues, so it composes with a status filter but returns nothing alongside a status that excludes them:
Only critical and medium are selectable. A Case whose failing rubrics are all low severity is recorded as a success — low findings still appear in the Case’s rubric breakdown, but they don’t hold the Case back, so no Case carries a low severity to filter on.
Use creation-time bounds to inspect Cases added during a fixed window:
Use update-time bounds to inspect Cases changed during a fixed window:
For both pairs, the lower bound is inclusive and the upper bound is exclusive. Adjacent windows do not count the same Case twice. Add --count-only when you need the matching total without Case rows. All Case filters still apply.
Setting priority never interrupts a Run or changes a Case’s status — it only affects the order pending Cases are picked up in.

Manage Case labels

Attach or remove labels on a Case for filtering and organization.
--label accepts either key=value (for keyed labels like priority=urgent) or just value on its own (for tag-style labels like urgent).

Queues (duvo queues)

Queue labels (duvo queue-labels)

Queue labels are reusable label definitions on a Queue. Once defined, a label can be attached to any Case in that Queue.

Scripting examples

Relabel a Case if it had runs created today