​

initiatives

orc initiatives は、WorkspaceのInitiativeを作成し、担当者・優先度・期日・状態を更新するコマンドです。所属するProjectの追加や並べ替え、進捗集計、コメントと更新投稿を扱い、お気に入りや購読も管理できます。削除したInitiativeは復元できます。

実行には認証とWorkspaceの選択が必要です。更新時には現在の応答から取得した version を指定します。Projectの追加には同じWorkspaceのProject IDを使用してください。

WorkspaceのInitiativeを一覧にします。

タブや状態で絞り込み、並び順とページを指定して一覧にします。--status とタブを併用した場合は、明示した状態が優先されます。

Convenience filter: active selects active; planned selects proposed and planned. all or omission applies no tab filter. An explicit status takes precedence.; enum: active|planned|all

型: string。任意。

Exact lifecycle-state filter. Overrides tab when both are supplied.

型: string。任意。

Sort field. Defaults to created_at; manual uses the shared numeric rank and target_date uses the target calendar date.; enum: created_at|target_date|manual

型: string。任意。

Sort direction. Defaults to descending for created_at and ascending for target_date or manual. Keep it unchanged while following a cursor.; enum: asc|desc

型: string。任意。

名前を指定してInitiativeを作成します。名前は前後の空白を除いて最大200文字で、空白だけの名前は拒否されます。担当者、優先度、期日、状態やラベルも指定できます。

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。任意。

Optional display color token. Null clears it; omission in an update preserves it.; (use "null" or "reset" to clear); max 100 chars

型: string。任意。

Description text. Use an empty string to clear it.; max 2000 chars

型: string。任意。

Optional display icon token. Null clears it; omission in an update preserves it.; (use "null" or "reset" to clear); max 100 chars

型: string。任意。

Complete label set. Labels are trimmed and must be unique. Use [] to clear; omission in an update preserves the set.; csv

型: string。任意。

(required) Initiative name. Leading and trailing whitespace is removed; a blank name is rejected.; max 200 chars

型: string。任意。

Owner user ID belonging to this workspace. Null clears the owner; omission in an update preserves it.; (use "null" or "reset" to clear)

型: string。任意。

Priority label, or null when unset. Omission in an update preserves it.; enum: urgent|high|medium|low|; (use "null" or "reset" to clear)

型: string。任意。

Body field: status

型: string。任意。

Target calendar date in YYYY-MM-DD form. Supply target_precision with it; set both to null to clear the target.; (use "null" or "reset" to clear)

型: string。任意。

Target date granularity. Supply target_date together with this field; both must be non-null or both null.; enum: day|month|quarter|half_year|year|; (use "null" or "reset" to clear)

型: string。任意。

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

Initiative IDと現在の version を指定して内容を更新します。古いバージョンは競合となります。優先度は省略すると保持し、null で解除します。説明を解除する場合は空文字を指定します。

Optional display color token. Null clears it; omission in an update preserves it.; (use "null" or "reset" to clear); max 100 chars

型: string。任意。

Description text. Use an empty string to clear it.; max 2000 chars

型: string。任意。

Optional display icon token. Null clears it; omission in an update preserves it.; (use "null" or "reset" to clear); max 100 chars

型: string。任意。

Complete label set. Labels are trimmed and must be unique. Use [] to clear; omission in an update preserves the set.; csv

型: string。任意。

Initiative name. Leading and trailing whitespace is removed; a blank name is rejected.; max 200 chars

型: string。任意。

Owner user ID belonging to this workspace. Null clears the owner; omission in an update preserves it.; (use "null" or "reset" to clear)

型: string。任意。

Priority label, or null when unset. Omission in an update preserves it.; enum: urgent|high|medium|low|; (use "null" or "reset" to clear)

型: string。任意。

Workspace-shared manual position as a non-negative decimal string. Lower values appear first for ascending manual order.; max 100 chars

型: string。任意。

Body field: status

型: string。任意。

Target calendar date in YYYY-MM-DD form. Supply target_precision with it; set both to null to clear the target.; (use "null" or "reset" to clear)

型: string。任意。

Target date granularity. Supply target_date together with this field; both must be non-null or both null.; enum: day|month|quarter|half_year|year|; (use "null" or "reset" to clear)

型: string。任意。

(required) Latest saved version from the Initiative response. A stale value returns a conflict; read the current resource before retrying.

型: number。任意。

Initiative IDを指定してソフトデリートします。

Initiativeの進捗集計を取得します。個別設定の取得とは別の操作です。

Initiativeに所属するProjectを一覧にします。--limit と --cursor でページを指定します。

同じWorkspaceの project_id を指定してInitiativeに追加します。所属の rank は非負整数で、省略するとProjectの表示順を使用します。

(required) ID of a project in the same workspace.

型: string。任意。

Non-negative integer membership rank. Defaults to the project display order when omitted.

型: number。任意。

Initiative ID、Project IDと新しい rank を指定して所属Projectを並べ替えます。非負整数の小さい値が先に表示されます。

(required) New non-negative integer membership rank. Lower values appear first.

型: number。任意。

Initiative IDとProject IDを指定して所属を解除します。Project自体をアーカイブする操作とは異なります。

Initiativeの変更履歴を一覧にします。

Initiativeのコメントを一覧にします。

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

(required) Comment text. Trimmed before validation; must contain 1 to 10000 characters.; max 10000 chars

型: string。任意。

Top-level comment ID in this initiative. Omit or pass null to start a thread. Replies to replies are rejected.; (use "null" or "reset" to clear); max 500 chars

型: string。任意。

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

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

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

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

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

Initiativeの更新投稿を一覧にします。

Initiative ID、本文の body と health を指定して更新投稿を作成します。通常のコメントとは別の投稿です。

(required) Progress-update text. Trimmed before validation; must contain 1 to 10000 characters.; max 10000 chars

型: string。任意。

(required) Body field: health

型: string。任意。

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。任意。

名前を指定してInitiativeを作成します。

取得した version と変更する項目をJSONに含めてください。

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

同じWorkspaceのProjectを追加します。

所属するProjectを並べ替えます。

Initiativeの進捗を集計します。

更新が競合した場合は、get で現在の内容と version を読み直し、変更内容を確認して再送します。一括操作では各項目の結果を確認してください。リクエスト全体が不正な場合は処理前に拒否されますが、個別の失敗で成功済みの項目が取り消されることはありません。

Initiative自身の手動位置 rank は非負の十進文字列です。一方、InitiativeへのProject所属の rank は非負整数です。異なるリソースの並び順なので、値の型を混同しないでください。

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

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