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.

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

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 <p>] [--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>.

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).

Atualizar

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.

Adicionar

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.

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).

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

Veja também

• uip resource queues — queue-level CRUD.
• uip resource overview — shared conventions for every uip resource verb.
• How-to: manage Orchestrator assets and queues — bulk patterns and CSV-driven dispatch.