# uip resource queue-items

> Manage **queue items** — individual work transactions inside queues. Items flow through states: `New → InProgress → Successful` / `Failed` / `Abandoned` / `Retried` / `Deleted`. Queue items are folder-scoped; most subcommands require `--folder-path` or `--folder-key`. For the queue itself, see [`uip resource queues`](./uip-resource-queues.md).

Manage **queue items** — individual work transactions inside queues. Items flow through states: `New → InProgress → Successful` / `Failed` / `Abandoned` / `Retried` / `Deleted`. Queue items are folder-scoped; most subcommands require `--folder-path` or `--folder-key`. For the queue itself, see [`uip resource queues`](./uip-resource-queues.md).

For the cross-resource conventions (auth, folder scoping, key types, output envelope), see the [`uip resource` overview](./uip-resource.md).

## Synopsis

```
uip resource queue-items list                <flags below>
uip resource queue-items get                 <queue-item-key>
uip resource queue-items update              <queue-item-key> [--progress <text>] [--priority ] [--due-date <iso>] [--defer-date <iso>] [--specific-content <json>]
uip resource queue-items set-progress        <queue-item-key> <progress>
uip resource queue-items delete              <queue-item-key>
uip resource queue-items delete-bulk         <queue-item-key...>
uip resource queue-items set-review-status   <status> <queue-item-key...>
uip resource queue-items set-reviewer        <queue-item-key...> --user-key <guid>
uip resource queue-items unset-reviewer      <queue-item-key...>
uip resource queue-items get-reviewers       [--folder-path <path> | --folder-key <key>]
uip resource queue-items get-history         <queue-item-key> [-l <n>] [--offset <n>]
uip resource queue-items get-last-retry      <retry-chain-key>
uip resource queue-items has-video           <queue-item-key>
uip resource queue-items add                 <queue-name> --folder-path <path> | --folder-key <key> --specific-content <json> [-r <ref>] [-p <priority>] [--defer-date <iso>] [--due-date <iso>]
uip resource queue-items bulk-add            <queue-name> --folder-path <path> | --folder-key <key> --queue-items <json-array> [--commit-type <mode>]
```

## list

List queue items in a folder. Filter: `--queue-definition-key <guid>` and/or `--queue-name <name>` and/or `--status <state>`.

```bash
uip resource queue-items list --folder-path Shared \
  --queue-name InvoiceQueue --status Failed
```

## get

Get a queue item by `<queue-item-key>` (the `uniqueKey` field from `list` output, unique per attempt).

## update

Change fields on a queue item. Optional `--progress`, `--priority <High|Normal|Low>`, `--due-date <ISO-8601>`, `--defer-date <ISO-8601>`, `--specific-content <json>`.

## set-progress

Update the progress text of an in-progress item: `set-progress <queue-item-key> <progress>`.

## delete / delete-bulk

Delete one or many items by `<queue-item-key>` / `<queue-item-key...>`. Bulk form requires all items to belong to the same folder.

## set-review-status

Set `<status>` (`Retried`, `Abandoned`, `Deleted`) for one or more `<queue-item-key...>`.

## set-reviewer / unset-reviewer

Assign or clear a reviewer on one or more `<queue-item-key...>`. `set-reviewer` requires `--user-key <guid>`.

## get-reviewers

List users available as reviewers (scoped by `--folder-path` / `--folder-key` if provided). Returned keys feed `set-reviewer --user-key`.

## get-history

Return the processing history for a queue item. Paginated via `-l, --limit` / `--offset`.

## get-last-retry

Return the most recent retry for an item. Argument is the **retry-chain key** (the `key` field from `list`, not `uniqueKey`).

## has-video

Return whether a queue item has a video recording attached.

## add

Add a single item to a queue by name. Requires `<queue-name>` and `--specific-content <json>`. Optional `-r, --reference`, `-p, --priority <High|Normal|Low>` (default `Normal`), `--defer-date`, `--due-date`.

```bash
uip resource queue-items add InvoiceQueue --folder-path Shared \
  --specific-content '{"InvoiceId":"INV-001","Amount":1500}'
```

## bulk-add

Add multiple items in one request. Requires `<queue-name>` and `--queue-items <json-array>`. Optional `--commit-type <AllOrNothing|StopOnFirstFailure|ProcessAllIndependently>` (default `ProcessAllIndependently`).

```bash
ITEMS=$(jq -c . ./items.json)
uip resource queue-items bulk-add InvoiceQueue \
  --folder-path Shared \
  --queue-items "$ITEMS" \
  --commit-type StopOnFirstFailure
```

## See also

- [`uip resource queues`](./uip-resource-queues.md) — queue-level CRUD.
- [`uip resource` overview](./uip-resource.md) — shared conventions for every `uip resource` verb.
- [How-to: manage Orchestrator assets and queues](./howto-manage-resources.md) — bulk patterns and CSV-driven dispatch.