---
title: issues
description: Manage Issue work, discussions, and views.
canonical_url: https://orchestor.io/docs/en/cli/issue
markdown_url: https://orchestor.io/docs/en/cli/issue.md
contentType: reference
---

# issues

`orc issues` creates Issues in a Workspace and updates their state, assignee, priority, and Project or Initiative associations. Inspect comments, activity, reactions, and related Issues, and manage personal display preferences and saved views. Deletion is a soft delete with a restore operation.

Authentication and a selected Workspace are required. Updates must include `version` from the current Issue. The `project_id` used for associations is a UUID, not a Project lookup key.

## Usage

```bash title="terminal"
orc issues list --json
```

*List Issues in the Workspace.*

## Subcommands

### `list`

Filters by state, priority, classification, Project, milestone, Initiative, assignee, label, or search query. Omitted filters leave that dimension unrestricted. You can also control ordering and completed or child Issue handling.

```bash title="terminal"
orc issues list [options]
```

#### Unique options

##### `--state`

Filter by exact workflow state. Omit to include all states.

Type: `string`. Optional.

```bash title="terminal"
orc issues list --state <value>
```

##### `--priority`

Filter by exact priority. Omit to include all priorities and unprioritized issues.

Type: `string`. Optional.

```bash title="terminal"
orc issues list --priority <value>
```

##### `--classification`

Filter by work classification. Omit to include all classifications.

Type: `string`. Optional.

```bash title="terminal"
orc issues list --classification <value>
```

##### `--project-id`

Filter by project UUID. Omit to include issues with or without a project.; max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues list --project-id <value>
```

##### `--milestone-id`

Filter by membership in this milestone. Omit to leave milestone membership unrestricted.; max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues list --milestone-id <value>
```

##### `--initiative-id`

Filter by initiative id. Omit to leave initiative assignment unrestricted.; max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues list --initiative-id <value>
```

##### `--assignee-id`

Filter by assigned member id. Omit to include assigned and unassigned issues.; max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues list --assignee-id <value>
```

##### `--label`

Require this exact label in the issue label list. Omit to leave labels unrestricted.; max 100 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues list --label <value>
```

##### `--query`

Case-insensitive search across internal id, title, description and rationale. SQL LIKE wildcards % and _ are supported. Omit to disable text filtering.; max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues list --query <value>
```

##### `--order-by`

Sort field. Defaults to created. Reuse the same ordering and filters with next_cursor.

Type: `string`. Optional.

```bash title="terminal"
orc issues list --order-by <value>
```

##### `--order-direction`

Override sort direction and the id tie-breaker. Defaults to descending for created/updated and ascending for the other sort fields.; enum: asc|desc

Type: `string`. Optional.

```bash title="terminal"
orc issues list --order-direction <value>
```

##### `--completed-by-recency`

When true, place done, closed and duplicate issues after unfinished work, ordered by newest state transition first. Defaults to false.; enum: true|false

Type: `string`. Optional.

```bash title="terminal"
orc issues list --completed-by-recency <value>
```

##### `--completed-window`

Filter terminal issues by their latest state transition: day=24 hours, week=7 days, month=one calendar month. none excludes terminal issues; all or omission imposes no time window. Unfinished issues are unaffected.; enum: all|day|week|month|none

Type: `string`. Optional.

```bash title="terminal"
orc issues list --completed-window <value>
```

##### `--show-sub-issues`

Set false to exclude children of non-deleted parent issues. Omitted or true includes them.; enum: true|false

Type: `string`. Optional.

```bash title="terminal"
orc issues list --show-sub-issues <value>
```

### `create`

Creates an Issue with `title` and `classification`. Titles are trimmed before storage and limited to 500 characters. You can also supply a description, state, priority, and associations within the same Workspace.

```bash title="terminal"
orc issues create [options]
```

#### Unique options

##### `--idempotency-key`

Retry identity for operations that support idempotency. Use a unique key for each new operation, and reuse it only when retrying the same HTTP method, path, query values and exact request body. JSON whitespace changes can count as a different body. Keys contain 1–255 characters after trimming and expire after 24 hours. A completed JSON response is replayed without repeating the operation. A different request using the same key returns 409 idempotency_error. An in-progress request returns 409 idempotency_in_progress with Retry-After: 2. Whether this header is required depends on the operation.

Type: `string`. Optional.

```bash title="terminal"
orc issues create --idempotency-key <value>
```

##### `--assignee-id`

Active workspace member to assign. Omitted on create means unassigned; null clears the assignment on update.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues create --assignee-id <value>
```

##### `--canonical-issue-id`

Active canonical issue in the same workspace. Required for state duplicate; must not reference this issue. Null clears the reference only when the resulting state permits it.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues create --canonical-issue-id <value>
```

##### `--classification`

(required) Body field: classification

Type: `string`. Optional.

```bash title="terminal"
orc issues create --classification <value>
```

##### `--description`

Issue details. Omit on create for null; on update omit to retain the value or send null to clear.; max 10000 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues create --description <value>
```

##### `--due-date`

Calendar due date in YYYY-MM-DD form. Omit on create for no due date; send null on update to clear it.; (use "null" or "reset" to clear)

Type: `string`. Optional.

```bash title="terminal"
orc issues create --due-date <value>
```

##### `--initiative-id`

Initiative id in the same workspace. Omit on create for no initiative; send null on update to remove it.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues create --initiative-id <value>
```

##### `--labels`

Unique labels after trimming. Defaults to [] on create. On update replaces all labels; [] clears them.; csv

Type: `string`. Optional.

```bash title="terminal"
orc issues create --labels <value>
```

##### `--observation-ref`

Body field: observation_ref

Type: `string`. Optional.

```bash title="terminal"
orc issues create --observation-ref <value>
```

##### `--priority`

Priority, or null for no priority. Omitted on create means null; omitted on update leaves it unchanged.; enum: urgent|high|medium|low|; (use "null" or "reset" to clear)

Type: `string`. Optional.

```bash title="terminal"
orc issues create --priority <value>
```

##### `--project-id`

Project UUID in the same workspace. Omit on create for no project; send null on update to remove it.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues create --project-id <value>
```

##### `--rationale`

Reason for this issue. Defaults to the trimmed title on create; omit on update to retain it.; max 10000 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues create --rationale <value>
```

##### `--state`

Body field: state

Type: `string`. Optional.

```bash title="terminal"
orc issues create --state <value>
```

##### `--target-entity-ref`

Body field: target_entity_ref

Type: `string`. Optional.

```bash title="terminal"
orc issues create --target-entity-ref <value>
```

##### `--title`

(required) Short issue title, trimmed before storage.; max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues create --title <value>
```

### `get`

Retrieves current information by Issue ID. Read the `version` for an update from this response.

```bash title="terminal"
orc issues get <id> [options]
```

### `update`

Updates an Issue using its ID and current `version`. A stale version returns `409 version_conflict`. Omitted descriptions and associations are preserved; fields that support clearing can be cleared with `null`.

```bash title="terminal"
orc issues update <id> [options]
```

#### Unique options

##### `--assignee-id`

Active workspace member to assign. Omitted on create means unassigned; null clears the assignment on update.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --assignee-id <value>
```

##### `--canonical-issue-id`

Active canonical issue in the same workspace. Required for state duplicate; must not reference this issue. Null clears the reference only when the resulting state permits it.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --canonical-issue-id <value>
```

##### `--classification`

Body field: classification

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --classification <value>
```

##### `--description`

Issue details. Omit on create for null; on update omit to retain the value or send null to clear.; (use "null" or "reset" to clear); max 10000 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --description <value>
```

##### `--due-date`

Calendar due date in YYYY-MM-DD form. Omit on create for no due date; send null on update to clear it.; (use "null" or "reset" to clear)

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --due-date <value>
```

##### `--initiative-id`

Initiative id in the same workspace. Omit on create for no initiative; send null on update to remove it.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --initiative-id <value>
```

##### `--labels`

Unique labels after trimming. Defaults to [] on create. On update replaces all labels; [] clears them.; csv

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --labels <value>
```

##### `--observation-ref`

Body field: observation_ref

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --observation-ref <value>
```

##### `--priority`

Priority, or null for no priority. Omitted on create means null; omitted on update leaves it unchanged.; enum: urgent|high|medium|low|; (use "null" or "reset" to clear)

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --priority <value>
```

##### `--project-id`

Project UUID in the same workspace. Omit on create for no project; send null on update to remove it.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --project-id <value>
```

##### `--rank`

Non-negative decimal string for the workspace-shared manual order. Omit to retain the current rank.; max 100 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --rank <value>
```

##### `--rationale`

Reason for this issue. Defaults to the trimmed title on create; omit on update to retain it.; max 10000 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --rationale <value>
```

##### `--state`

Body field: state

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --state <value>
```

##### `--target-entity-ref`

Body field: target_entity_ref

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --target-entity-ref <value>
```

##### `--title`

Short issue title, trimmed before storage.; max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues update <id> --title <value>
```

##### `--version`

(required) Version read from the current Issue. A stale version returns 409 version_conflict.

Type: `number`. Optional.

```bash title="terminal"
orc issues update <id> --version <value>
```

### `delete`

Soft-deletes an Issue by ID. Use `restore` to restore it.

```bash title="terminal"
orc issues delete <id> [options]
```

### `activity list`

Lists Issue activity. Paginate with `--limit` and `--cursor`.

```bash title="terminal"
orc issues activity list <id> [options]
```

### `comments list`

Lists Issue comments. Paginate with `--limit` and `--cursor`.

```bash title="terminal"
orc issues comments list <id> [options]
```

### `comments create`

Posts a comment using an Issue ID and `body`. Specify `parent_id` for a reply.

```bash title="terminal"
orc issues comments create <id> [options]
```

#### Unique options

##### `--body`

(required) Comment text, trimmed before storage.; max 10000 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues comments create <id> --body <value>
```

##### `--parent-id`

Top-level comment id on this issue to reply to. Omit or null for a new top-level comment. Replies to replies are rejected with 422.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues comments create <id> --parent-id <value>
```

### `favorites enable`

Adds the specified Issue to favorites.

```bash title="terminal"
orc issues favorites enable <id> [options]
```

### `favorites disable`

Removes the specified Issue from favorites.

```bash title="terminal"
orc issues favorites disable <id> [options]
```

### `reactions list`

Lists reactions on an Issue.

```bash title="terminal"
orc issues reactions list <id> [options]
```

### `reactions create`

Adds a reaction using an Issue ID and `emoji`. Specify `comment_id` for a reaction to a comment.

```bash title="terminal"
orc issues reactions create <id> [options]
```

#### Unique options

##### `--comment-id`

Comment on the same issue to react to. Omit or null to react to the issue itself.; (use "null" or "reset" to clear); max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues reactions create <id> --comment-id <value>
```

##### `--emoji`

(required) Reaction text, trimmed before storage.; max 64 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues reactions create <id> --emoji <value>
```

### `reactions delete`

Removes a reaction using an Issue ID and emoji. Also specify `--comment-id` when the target is a comment.

```bash title="terminal"
orc issues reactions delete <id> <emoji> [options]
```

#### Unique options

##### `--comment-id`

Comment id on this issue. Omit to remove the reaction on the issue body.; (use "null" or "reset" to clear)

Type: `string`. Optional.

```bash title="terminal"
orc issues reactions delete <id> <emoji> --comment-id <value>
```

### `restore`

Restores a soft-deleted Issue by ID.

```bash title="terminal"
orc issues restore <id> [options]
```

### `subscriptions enable`

Subscribes to the specified Issue.

```bash title="terminal"
orc issues subscriptions enable <id> [options]
```

### `subscriptions disable`

Unsubscribes from the specified Issue.

```bash title="terminal"
orc issues subscriptions disable <id> [options]
```

### `preferences get`

Retrieves your personal Issue display preferences, separate from Issue data and shared views.

```bash title="terminal"
orc issues preferences get [options]
```

### `preferences update`

Saves personal settings such as filters, grouping, layout, and ordering. Send a complete settings resource with `--stdin`.

```bash title="terminal"
orc issues preferences update [options]
```

#### Unique options

##### `--completed-by-recency`

(required) Whether completed issues follow unfinished issues in newest-transition order.

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --completed-by-recency <value>
```

##### `--completed-window`

Saved terminal-issue time window: all, day, week, month or none.; enum: all|day|week|month|none

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --completed-window <value>
```

##### `--display-properties`

(required) Ordered list of issue properties to display. Values must be unique. An empty array saves no optional display properties.; csv of: id|status|assignee|priority|project|initiative|labels|created|updated|dueDate|timeInStatus

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --display-properties <value>
```

##### `--filter`

(required) Body field: filter

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --filter <value>
```

##### `--grouping`

(required) Body field: grouping

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --grouping <value>
```

##### `--grouping-direction`

Optional saved group ordering direction.; enum: asc|desc

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --grouping-direction <value>
```

##### `--layout`

(required) Body field: layout

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --layout <value>
```

##### `--ordering`

(required) Body field: ordering

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --ordering <value>
```

##### `--ordering-direction`

Optional saved issue sort direction.; enum: asc|desc

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --ordering-direction <value>
```

##### `--show-completed`

(required) Whether the view displays completed issues.

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --show-completed <value>
```

##### `--show-empty-columns`

(required) Whether the view displays empty groups or board columns.

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --show-empty-columns <value>
```

##### `--show-sub-issues`

Saved option controlling whether child issues are shown.

Type: `string`. Optional.

```bash title="terminal"
orc issues preferences update --show-sub-issues <value>
```

### `views list`

Lists IssueViews visible to the current authenticated principal.

```bash title="terminal"
orc issues views list [options]
```

### `views create`

Creates an IssueView with a name, visibility, filter, grouping, layout, and ordering. This is separate from `saved-views`, which stores query filters only.

```bash title="terminal"
orc issues views create [options]
```

#### Unique options

##### `--completed-by-recency`

(required) Whether completed issues follow unfinished issues in newest-transition order.

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --completed-by-recency <value>
```

##### `--completed-window`

Saved terminal-issue time window: all, day, week, month or none.; enum: all|day|week|month|none

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --completed-window <value>
```

##### `--display-properties`

(required) Ordered list of issue properties to display. Values must be unique. An empty array saves no optional display properties.; csv of: id|status|assignee|priority|project|initiative|labels|created|updated|dueDate|timeInStatus

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --display-properties <value>
```

##### `--filter`

(required) Body field: filter

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --filter <value>
```

##### `--grouping`

(required) Body field: grouping

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --grouping <value>
```

##### `--grouping-direction`

Optional saved group ordering direction.; enum: asc|desc

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --grouping-direction <value>
```

##### `--layout`

(required) Body field: layout

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --layout <value>
```

##### `--name`

(required) Display name for the saved view.; max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --name <value>
```

##### `--ordering`

(required) Body field: ordering

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --ordering <value>
```

##### `--ordering-direction`

Optional saved issue sort direction.; enum: asc|desc

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --ordering-direction <value>
```

##### `--show-completed`

(required) Whether the view displays completed issues.

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --show-completed <value>
```

##### `--show-empty-columns`

(required) Whether the view displays empty groups or board columns.

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --show-empty-columns <value>
```

##### `--show-sub-issues`

Saved option controlling whether child issues are shown.

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --show-sub-issues <value>
```

##### `--visibility`

(required) Body field: visibility

Type: `string`. Optional.

```bash title="terminal"
orc issues views create --visibility <value>
```

### `views get`

Retrieves an IssueView by view ID.

```bash title="terminal"
orc issues views get <id> [options]
```

### `views update`

Updates the name, filter, layout, and other settings of a view ID. An omitted filter is preserved; `null` clears it.

```bash title="terminal"
orc issues views update <id> [options]
```

#### Unique options

##### `--completed-by-recency`

Replacement completion ordering option. Omit to retain it.

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --completed-by-recency <value>
```

##### `--completed-window`

Saved terminal-issue time window: all, day, week, month or none.; enum: all|day|week|month|none

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --completed-window <value>
```

##### `--display-properties`

Replacement ordered display-property list. Values must be unique. Omit to retain the current list; send an empty array to clear it.; csv of: id|status|assignee|priority|project|initiative|labels|created|updated|dueDate|timeInStatus

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --display-properties <value>
```

##### `--filter`

Replacement filter conjunction. Null clears the filter; omission retains it.; (JSON object, e.g. '{"custom_id":"x"}'); (use "null" or "reset" to clear)

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --filter <value>
```

##### `--grouping`

Body field: grouping

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --grouping <value>
```

##### `--grouping-direction`

Optional saved group ordering direction.; enum: asc|desc

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --grouping-direction <value>
```

##### `--layout`

Body field: layout

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --layout <value>
```

##### `--name`

Replacement display name. Omit to retain it.; max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --name <value>
```

##### `--ordering`

Body field: ordering

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --ordering <value>
```

##### `--ordering-direction`

Optional saved issue sort direction.; enum: asc|desc

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --ordering-direction <value>
```

##### `--show-completed`

Replacement completed-issue visibility. Omit to retain it.

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --show-completed <value>
```

##### `--show-empty-columns`

Replacement empty-column visibility. Omit to retain it.

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --show-empty-columns <value>
```

##### `--show-sub-issues`

Saved option controlling whether child issues are shown.

Type: `string`. Optional.

```bash title="terminal"
orc issues views update <id> --show-sub-issues <value>
```

### `views delete`

Deletes an IssueView by view ID.

```bash title="terminal"
orc issues views delete <id> [options]
```

### `views defaults enable`

Sets the default view using a view ID and `scope`. `personal` applies only to you; `workspace` changes the shared default and requires Workspace owner permission.

```bash title="terminal"
orc issues views defaults enable <id> [options]
```

#### Unique options

##### `--scope`

(required) personal changes only your default view. workspace changes the shared default and requires workspace owner permission.; enum: personal|workspace

Type: `string`. Optional.

```bash title="terminal"
orc issues views defaults enable <id> --scope <value>
```

### `views defaults disable`

Clears the default view using a view ID and `scope`. `personal` and `workspace` have the same permission boundaries as setting a default.

```bash title="terminal"
orc issues views defaults disable <id> [options]
```

#### Unique options

##### `--scope`

(required) personal changes only your default view. workspace changes the shared default and requires workspace owner permission.; enum: personal|workspace

Type: `string`. Optional.

```bash title="terminal"
orc issues views defaults disable <id> --scope <value>
```

### `relations list`

Lists relations for the specified Issue.

```bash title="terminal"
orc issues relations list <id> [options]
```

### `relations create`

Creates a relation using `type` and another active Issue in the same Workspace in `related_issue_id`. An Issue cannot relate to itself.

```bash title="terminal"
orc issues relations create <id> [options]
```

#### Unique options

##### `--related-issue-id`

(required) Other active issue in the same workspace. Must not be the source issue.; max 500 chars

Type: `string`. Optional.

```bash title="terminal"
orc issues relations create <id> --related-issue-id <value>
```

##### `--type`

(required) Body field: type

Type: `string`. Optional.

```bash title="terminal"
orc issues relations create <id> --type <value>
```

### `relations delete`

Removes a relation using an Issue ID and relation ID.

```bash title="terminal"
orc issues relations delete <id> <relation-id> [options]
```

### `batch update`

Executes multiple actions supplied in JSON `items`. Items are processed independently in input order; result indices refer to the input array. Individual failures do not roll back successful actions.

```bash title="terminal"
orc issues batch update [options]
```

#### Unique options

##### `--idempotency-key`

Retry identity for operations that support idempotency. Use a unique key for each new operation, and reuse it only when retrying the same HTTP method, path, query values and exact request body. JSON whitespace changes can count as a different body. Keys contain 1–255 characters after trimming and expire after 24 hours. A completed JSON response is replayed without repeating the operation. A different request using the same key returns 409 idempotency_error. An in-progress request returns 409 idempotency_in_progress with Retry-After: 2. Whether this header is required depends on the operation.

Type: `string`. Optional.

```bash title="terminal"
orc issues batch update --idempotency-key <value>
```

##### `--items`

(required) Actions processed independently in input order. Each result index refers to this array. A malformed request is rejected before processing; reported item failures do not roll back successful items.; JSON array of objects (use --stdin for large resources)

Type: `string`. Optional.

```bash title="terminal"
orc issues batch update --items <value>
```

## Examples

### Filter Issues by a Project UUID.

```bash title="terminal"
orc issues list --project-id PROJECT_ID --json
```

*Filter Issues by a Project UUID.*

### Read the current Issue and submit an update file.

Include the retrieved `version` and fields to change in the update file.

```bash title="terminal"
orc issues get ISSUE_ID --json
orc issues update ISSUE_ID --stdin < issue-update.json --json
```

*Read the current Issue and submit an update file.*

### Post a comment on an Issue.

```bash title="terminal"
orc issues comments create ISSUE_ID --body "Checked the reproduction steps." --json
```

*Post a comment on an Issue.*

### Set your personal default view.

```bash title="terminal"
orc issues views defaults enable VIEW_ID --scope personal --json
```

*Set your personal default view.*

## Conflicts and batch operations

If an update returns `409 version_conflict`, read the current content and `version` with `get`, review the intended changes, and resubmit. Do not retry with the stale version.

Malformed batch requests are rejected before processing, but individual errors after processing begins can result in partial success. Check each result index and outcome to avoid repeating successful items.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc issues`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--limit`](https://orchestor.io/docs/cli/global-flags.md)
- [`--cursor`](https://orchestor.io/docs/cli/global-flags.md)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)