Getting started

issues

This page is the command reference for @orchestor-inc/cli.

Commands

orc issues list — List Issues
orc issues create — Create an Issue
orc issues get — Get an Issue
orc issues update — Update an Issue
orc issues delete — Soft-delete an Issue
orc issues activity list — List Issue activity
orc issues comments list — List Issue comments
orc issues comments create — Comment on an Issue
orc issues favorites enable — Favorite an Issue
orc issues favorites disable — Unfavorite an Issue
orc issues reactions list — List Issue reactions
orc issues reactions create — React to an Issue
orc issues reactions delete — Remove an Issue reaction
orc issues restore — Restore an Issue
orc issues subscriptions enable — Subscribe to an Issue
orc issues subscriptions disable — Unsubscribe from an Issue
orc issues preferences get — Get personal Issue preferences
orc issues preferences update — Save personal Issue preferences
orc issues views list — List visible IssueViews
orc issues views create — Create an IssueView
orc issues views get — Get an IssueView
orc issues views update — Update an IssueView
orc issues views delete — Delete an IssueView
orc issues views defaults enable — Set an IssueView default
orc issues views defaults disable — Clear an IssueView default
orc issues relations list — List Issue relations
orc issues relations create — Create an Issue relation
orc issues relations delete — Delete an Issue relation
orc issues batch update — Batch Issue operations

orc issues list

List Issues

Usage

orc issues list [flags]

Flags

Flag	Type	Required	Description
`--state`	`string`	No	enum: triage\|backlog\|in_progress\|in_review\|done\|closed\|duplicate
`--priority`	`string`	No	enum: urgent\|high\|medium\|low
`--classification`	`string`	No	enum: owned\|earned\|community
`--project-id`	`string`	No	max 500 chars
`--initiative-id`	`string`	No	max 500 chars
`--assignee-id`	`string`	No	max 500 chars
`--label`	`string`	No	max 100 chars
`--query`	`string`	No	max 500 chars
`--order-by`	`string`	No	enum: title\|priority\|updated\|created\|manual
`--limit`	`number`	No	Maximum number of items to return
`--cursor`	`string`	No	Opaque cursor for the next page

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue list

Help

orc issues list --help

orc issues create

Create an Issue

Usage

orc issues create [flags]

Flags

Flag	Type	Required	Description
`--idempotency-key`	`string`	No	Unique key for idempotent POST requests (24h TTL). If a request with the same key was already processed, the original response is returned without re-executing the operation. Reusing a key with a different request payload returns `409 idempotency_error`. Use a UUID v4 or similar unique identifier.
`--assignee-id`	`string`	No	Body field: assignee_id; max 500 chars
`--canonical-issue-id`	`string`	No	Body field: canonical_issue_id; max 500 chars
`--classification`	`string`	No	(required) Body field: classification; enum: owned\|earned\|community
`--description`	`string`	No	Body field: description; max 10000 chars
`--due-date`	`string`	No	Body field: due_date
`--initiative-id`	`string`	No	Body field: initiative_id; max 500 chars
`--labels`	`string`	No	Body field: labels; csv
`--observation-ref`	`string`	No	Body field: observation_ref; (JSON object, e.g. '{"custom_id":"x"}')
`--priority`	`string`	No	Body field: priority; enum: urgent\|high\|medium\|low\|
`--project-id`	`string`	No	Body field: project_id; max 500 chars
`--rationale`	`string`	No	Body field: rationale; max 10000 chars
`--state`	`string`	No	Body field: state; enum: triage\|backlog\|in_progress\|in_review\|done\|closed\|duplicate
`--target-entity-ref`	`string`	No	Body field: target_entity_ref; (JSON object, e.g. '{"custom_id":"x"}')
`--title`	`string`	No	(required) Body field: title; max 500 chars

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue create

Help

orc issues create --help

orc issues get

Get an Issue

Usage

orc issues get <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue get

Help

orc issues get --help

orc issues update

Update an Issue

Usage

orc issues update <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

Flags

Flag	Type	Required	Description
`--assignee-id`	`string`	No	Body field: assignee_id; max 500 chars
`--canonical-issue-id`	`string`	No	Body field: canonical_issue_id; max 500 chars
`--classification`	`string`	No	Body field: classification; enum: owned\|earned\|community
`--description`	`string`	No	Body field: description; max 10000 chars
`--due-date`	`string`	No	Body field: due_date
`--initiative-id`	`string`	No	Body field: initiative_id; max 500 chars
`--labels`	`string`	No	Body field: labels; csv
`--observation-ref`	`string`	No	Body field: observation_ref; (JSON object, e.g. '{"custom_id":"x"}')
`--priority`	`string`	No	Body field: priority; enum: urgent\|high\|medium\|low\|
`--project-id`	`string`	No	Body field: project_id; max 500 chars
`--rank`	`string`	No	Body field: rank; max 100 chars
`--rationale`	`string`	No	Body field: rationale; max 10000 chars
`--state`	`string`	No	Body field: state; enum: triage\|backlog\|in_progress\|in_review\|done\|closed\|duplicate
`--target-entity-ref`	`string`	No	Body field: target_entity_ref; (JSON object, e.g. '{"custom_id":"x"}')
`--title`	`string`	No	Body field: title; max 500 chars
`--version`	`number`	No	(required) Body field: version

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue update

Help

orc issues update --help

orc issues delete

Soft-delete an Issue

Usage

orc issues delete <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue delete

Help

orc issues delete --help

orc issues activity list

List Issue activity

Usage

orc issues activity list <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue activity

Help

orc issues activity list --help

orc issues comments list

List Issue comments

Usage

orc issues comments list <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue comments

Help

orc issues comments list --help

orc issues comments create

Comment on an Issue

Usage

orc issues comments create <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

Flags

Flag	Type	Required	Description
`--body`	`string`	No	(required) Body field: body; max 10000 chars
`--parent-id`	`string`	No	Body field: parent_id; max 500 chars

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue comment

Help

orc issues comments create --help

orc issues favorites enable

Favorite an Issue

Usage

orc issues favorites enable <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue favorite

Help

orc issues favorites enable --help

orc issues favorites disable

Unfavorite an Issue

Usage

orc issues favorites disable <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue unfavorite

Help

orc issues favorites disable --help

orc issues reactions list

List Issue reactions

Usage

orc issues reactions list <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue reactions

Help

orc issues reactions list --help

orc issues reactions create

React to an Issue

Usage

orc issues reactions create <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

Flags

Flag	Type	Required	Description
`--comment-id`	`string`	No	Body field: comment_id; max 500 chars
`--emoji`	`string`	No	(required) Body field: emoji; max 64 chars

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue react

Help

orc issues reactions create --help

orc issues reactions delete

Remove an Issue reaction

Usage

orc issues reactions delete <id> <emoji> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id
`emoji`	Yes	Path parameter: emoji

Flags

Flag	Type	Required	Description
`--comment-id`	`string`	No	(use "null" or "reset" to clear)

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue unreact

Help

orc issues reactions delete --help

orc issues restore

Restore an Issue

Usage

orc issues restore <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue restore

Help

orc issues restore --help

orc issues subscriptions enable

Subscribe to an Issue

Usage

orc issues subscriptions enable <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue subscribe

Help

orc issues subscriptions enable --help

orc issues subscriptions disable

Unsubscribe from an Issue

Usage

orc issues subscriptions disable <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue unsubscribe

Help

orc issues subscriptions disable --help

orc issues preferences get

Get personal Issue preferences

Usage

orc issues preferences get [flags]

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc issues preferences get --help

orc issues preferences update

Save personal Issue preferences

Usage

orc issues preferences update [flags]

Flags

Flag	Type	Required	Description
`--completed-by-recency`	`string`	No	(required) Body field: completed_by_recency
`--display-properties`	`string`	No	(required) Body field: display_properties; csv of: id\|status\|assignee\|priority\|project\|initiative\|labels\|created\|updated
`--filter`	`string`	No	(required) Body field: filter
`--grouping`	`string`	No	(required) Body field: grouping; enum: status\|classification\|assignee\|project\|priority\|label
`--layout`	`string`	No	(required) Body field: layout; enum: list\|board
`--ordering`	`string`	No	(required) Body field: ordering; enum: title\|priority\|updated\|created\|manual
`--show-completed`	`string`	No	(required) Body field: show_completed
`--show-empty-columns`	`string`	No	(required) Body field: show_empty_columns

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc issues preferences update --help

orc issues views list

List visible IssueViews

Usage

orc issues views list [flags]

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc issues views list --help

orc issues views create

Create an IssueView

Usage

orc issues views create [flags]

Flags

Flag	Type	Required	Description
`--completed-by-recency`	`string`	No	(required) Body field: completed_by_recency
`--display-properties`	`string`	No	(required) Body field: display_properties; csv of: id\|status\|assignee\|priority\|project\|initiative\|labels\|created\|updated
`--filter`	`string`	No	(required) Body field: filter
`--grouping`	`string`	No	(required) Body field: grouping; enum: status\|classification\|assignee\|project\|priority\|label
`--layout`	`string`	No	(required) Body field: layout; enum: list\|board
`--name`	`string`	No	(required) Body field: name; max 200 chars
`--ordering`	`string`	No	(required) Body field: ordering; enum: title\|priority\|updated\|created\|manual
`--show-completed`	`string`	No	(required) Body field: show_completed
`--show-empty-columns`	`string`	No	(required) Body field: show_empty_columns
`--visibility`	`string`	No	(required) Body field: visibility; enum: personal\|workspace

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc issues views create --help

orc issues views get

Get an IssueView

Usage

orc issues views get <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc issues views get --help

orc issues views update

Update an IssueView

Usage

orc issues views update <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

Flags

Flag	Type	Required	Description
`--completed-by-recency`	`string`	No	Body field: completed_by_recency
`--display-properties`	`string`	No	Body field: display_properties; csv of: id\|status\|assignee\|priority\|project\|initiative\|labels\|created\|updated
`--filter`	`string`	No	Body field: filter
`--grouping`	`string`	No	Body field: grouping; enum: status\|classification\|assignee\|project\|priority\|label
`--layout`	`string`	No	Body field: layout; enum: list\|board
`--name`	`string`	No	Body field: name; max 200 chars
`--ordering`	`string`	No	Body field: ordering; enum: title\|priority\|updated\|created\|manual
`--show-completed`	`string`	No	Body field: show_completed
`--show-empty-columns`	`string`	No	Body field: show_empty_columns

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc issues views update --help

orc issues views delete

Delete an IssueView

Usage

orc issues views delete <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc issues views delete --help

orc issues views defaults enable

Set an IssueView default

Usage

orc issues views defaults enable <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

Flags

Flag	Type	Required	Description
`--scope`	`string`	No	(required) Body field: scope; enum: personal\|workspace

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc issues views defaults enable --help

orc issues views defaults disable

Clear an IssueView default

Usage

orc issues views defaults disable <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

Flags

Flag	Type	Required	Description
`--scope`	`string`	No	(required) Body field: scope; enum: personal\|workspace

See global flags for output and request options. Use --help to check the flags supported by this command.

Help

orc issues views defaults disable --help

orc issues relations list

List Issue relations

Usage

orc issues relations list <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue relations

Help

orc issues relations list --help

orc issues relations create

Create an Issue relation

Usage

orc issues relations create <id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id

Flags

Flag	Type	Required	Description
`--related-issue-id`	`string`	No	(required) Body field: related_issue_id; max 500 chars
`--type`	`string`	No	(required) Body field: type; enum: related\|blocking\|duplicate\|parent

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue relate

Help

orc issues relations create --help

orc issues relations delete

Delete an Issue relation

Usage

orc issues relations delete <id> <relation-id> [flags]

Arguments

Argument	Required	Description
`id`	Yes	Path parameter: id
`relation-id`	Yes	Path parameter: relation_id

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue unrelate

Help

orc issues relations delete --help

orc issues batch update

Batch Issue operations

Usage

orc issues batch update [flags]

Flags

Flag	Type	Required	Description
`--idempotency-key`	`string`	No	Unique key for idempotent POST requests (24h TTL). If a request with the same key was already processed, the original response is returned without re-executing the operation. Reusing a key with a different request payload returns `409 idempotency_error`. Use a UUID v4 or similar unique identifier.
`--items`	`string`	No	(required) Body field: items; JSON array of objects (use --stdin for large resources)

See global flags for output and request options. Use --help to check the flags supported by this command.

Compatibility aliases

orc issue batch-update

Help

orc issues batch update --help

​issues

​Commands

​orc issues list

​Usage

​Flags

​Compatibility aliases

​Help

​orc issues create

​Usage

​Flags

​Compatibility aliases

​Help

​orc issues get

​Usage

​Arguments

​Compatibility aliases

​Help

​orc issues update

​Usage

​Arguments

​Flags

​Compatibility aliases

​Help

​orc issues delete

​Usage

​Arguments

​Compatibility aliases

​Help

​orc issues activity list

​Usage

​Arguments

​Compatibility aliases

​Help

​orc issues comments list

​Usage

​Arguments

​Compatibility aliases

​Help

​orc issues comments create

​Usage

​Arguments

​Flags

​Compatibility aliases

​Help

​orc issues favorites enable

​Usage

​Arguments

​Compatibility aliases

​Help

​orc issues favorites disable

​Usage

​Arguments

​Compatibility aliases

​Help

​orc issues reactions list

​Usage

​Arguments

​Compatibility aliases

​Help

​orc issues reactions create

​Usage

​Arguments

​Flags

​Compatibility aliases

​Help

​orc issues reactions delete

​Usage

​Arguments

​Flags

​Compatibility aliases

​Help

​orc issues restore

​Usage

​Arguments

​Compatibility aliases

​Help

​orc issues subscriptions enable

​Usage

​Arguments

​Compatibility aliases

issues

Commands

orc issues list

Usage

Flags

Compatibility aliases

Help

orc issues create

Usage

Flags

Compatibility aliases

Help

orc issues get

Usage

Arguments

Compatibility aliases

Help

orc issues update

Usage

Arguments

Flags

Compatibility aliases

Help

orc issues delete

Usage

Arguments

Compatibility aliases

Help

orc issues activity list

Usage

Arguments

Compatibility aliases

Help

orc issues comments list

Usage

Arguments

Compatibility aliases

Help

orc issues comments create

Usage

Arguments

Flags

Compatibility aliases

Help

orc issues favorites enable

Usage

Arguments

Compatibility aliases

Help

orc issues favorites disable

Usage

Arguments

Compatibility aliases

Help

orc issues reactions list

Usage

Arguments

Compatibility aliases

Help

orc issues reactions create

Usage

Arguments

Flags

Compatibility aliases

Help

orc issues reactions delete

Usage

Arguments

Flags

Compatibility aliases

Help

orc issues restore

Usage

Arguments

Compatibility aliases

Help

orc issues subscriptions enable

Usage

Arguments

Compatibility aliases