​

issues

orc issues は、WorkspaceのIssueを作成し、状態・担当者・優先度・ProjectやInitiativeへの所属を更新するコマンドです。コメント・履歴・リアクション・関連Issueを確認し、個人の表示設定や保存ビューも管理できます。削除はソフトデリートで、復元操作に対応します。

実行には認証とWorkspaceの選択が必要です。更新時は現在のIssueから取得した version を指定してください。Projectの関連付けに使用する project_id はUUIDで、Projectの検索キーとは異なります。

WorkspaceのIssueを一覧にします。

状態、優先度、分類、Project、マイルストーン、Initiative、担当者、ラベルや検索語で絞り込みます。指定を省略した条件では対象を制限しません。並び順や完了済み・子Issueの扱いも指定できます。

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

型: string。任意。

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

型: string。任意。

Filter by work classification. Omit to include all classifications.

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

title と classification を指定してIssueを作成します。タイトルは前後の空白を除いて保存され、最大500文字です。説明、状態、優先度や同じWorkspaceの所属を併せて指定できます。

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.

型: string。任意。

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

型: string。任意。

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

型: string。任意。

(required) Body field: classification

型: string。任意。

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

型: string。任意。

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)

型: string。任意。

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

型: string。任意。

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

型: string。任意。

Body field: observation_ref

型: string。任意。

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)

型: string。任意。

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

型: string。任意。

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

型: string。任意。

Body field: state

型: string。任意。

Body field: target_entity_ref

型: string。任意。

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

型: string。任意。

Issue IDを指定して現在の情報を取得します。更新に使用する version はこの応答から取得します。

Issue IDと現在の version を指定して内容を更新します。古いバージョンでは 409 version_conflict が返ります。省略した説明や所属は保持し、解除に対応する項目は null で解除できます。

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

型: string。任意。

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

型: string。任意。

Body field: classification

型: string。任意。

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

型: string。任意。

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)

型: string。任意。

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

型: string。任意。

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

型: string。任意。

Body field: observation_ref

型: string。任意。

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)

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

Body field: state

型: string。任意。

Body field: target_entity_ref

型: string。任意。

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

型: string。任意。

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

型: number。任意。

Issue IDを指定してソフトデリートします。復元する場合は restore を使用します。

Issueの変更履歴を一覧にします。--limit と --cursor でページを指定します。

Issueのコメントを一覧にします。--limit と --cursor でページを指定します。

Issue IDと body を指定してコメントを投稿します。返信では parent_id を指定できます。

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

型: string。任意。

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

型: string。任意。

指定したIssueをお気に入りに追加します。

指定したIssueをお気に入りから外します。

Issueのリアクションを一覧にします。

Issue IDと emoji を指定してリアクションを追加します。コメントへのリアクションでは 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

型: string。任意。

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

型: string。任意。

Issue IDと絵文字を指定してリアクションを除外します。コメントが対象の場合は --comment-id も指定します。

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

型: string。任意。

ソフトデリートしたIssueをIDで指定して復元します。

指定したIssueを購読します。

指定したIssueの購読を解除します。

本人のIssue表示設定を取得します。Issueそのものの設定や共有ビューとは別です。

フィルター、グループ分け、レイアウト、並び順などの個人設定を保存します。完全な設定リソースを --stdin で送信できます。

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

型: string。任意。

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

型: string。任意。

(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

型: string。任意。

(required) Body field: filter

型: string。任意。

(required) Body field: grouping

型: string。任意。

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

型: string。任意。

(required) Body field: layout

型: string。任意。

(required) Body field: ordering

型: string。任意。

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

型: string。任意。

(required) Whether the view displays completed issues.

型: string。任意。

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

型: string。任意。

Saved option controlling whether child issues are shown.

型: string。任意。

現在の認証主体が参照できるIssueViewを一覧にします。

名前、公開範囲、フィルター、グループ分け、レイアウト、並び順を指定してIssueViewを作成します。クエリーフィルターのみの saved-views とは別のリソースです。

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

型: string。任意。

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

型: string。任意。

(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

型: string。任意。

(required) Body field: filter

型: string。任意。

(required) Body field: grouping

型: string。任意。

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

型: string。任意。

(required) Body field: layout

型: string。任意。

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

型: string。任意。

(required) Body field: ordering

型: string。任意。

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

型: string。任意。

(required) Whether the view displays completed issues.

型: string。任意。

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

型: string。任意。

Saved option controlling whether child issues are shown.

型: string。任意。

(required) Body field: visibility

型: string。任意。

ビューIDを指定してIssueViewを取得します。

ビューIDを指定し、名前やフィルター、レイアウトなどを更新します。フィルターは省略すると保持し、null で解除します。

Replacement completion ordering option. Omit to retain it.

型: string。任意。

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

Body field: grouping

型: string。任意。

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

型: string。任意。

Body field: layout

型: string。任意。

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

型: string。任意。

Body field: ordering

型: string。任意。

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

型: string。任意。

Replacement completed-issue visibility. Omit to retain it.

型: string。任意。

Replacement empty-column visibility. Omit to retain it.

型: string。任意。

Saved option controlling whether child issues are shown.

型: string。任意。

ビューIDを指定してIssueViewを削除します。

ビューIDと scope を指定して既定ビューに設定します。personal は本人だけに適用し、workspace は共有既定値を変更するためWorkspace owner権限が必要です。

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

型: string。任意。

ビューIDと scope を指定して既定ビューを解除します。personal と workspace の権限範囲は設定時と同じです。

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

型: string。任意。

指定したIssueの関連Issueを一覧にします。

同じWorkspaceの別の有効なIssueを related_issue_id に指定し、type を指定して関連付けます。自分自身を関連先にはできません。

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

型: string。任意。

(required) Body field: type

型: string。任意。

Issue IDと関係IDを指定して関連付けを解除します。

JSONの items に複数の操作を指定して実行します。各項目を入力順に独立して処理し、応答のindexは入力配列に対応します。個別の失敗は成功済みの操作をロールバックしません。

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.

型: string。任意。

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

型: string。任意。

ProjectのUUIDでIssueを絞り込みます。

更新ファイルには取得した version と変更する項目を含めてください。

現在のIssueを取得して更新用ファイルを送信します。

Issueにコメントを投稿します。

自分の既定ビューを設定します。

更新で 409 version_conflict が返った場合は、get で現在の内容と version を読み直し、必要な変更を確認して再送します。古いバージョンのまま再試行しないでください。

一括操作の不正なリクエストは処理前に拒否されますが、処理が始まった後の個別エラーは部分成功になります。応答の各indexと結果を確認し、成功した項目を重複実行しないようにしてください。

orc issues では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。