initiatives
This page is the command reference for @orchestor-inc/cli.
Commands
orc initiatives list— List workspace initiativesorc initiatives create— Create a workspace initiativeorc initiatives get— Get an initiativeorc initiatives update— Update an initiativeorc initiatives delete— Soft-delete an Initiativeorc initiatives rollup get— Get initiative progress rolluporc initiatives projects list— List Initiative Projectsorc initiatives projects create— Add a Project to an Initiativeorc initiatives projects update— Reorder an Initiative Projectorc initiatives projects delete— Remove a Project from an Initiativeorc initiatives activity list— List Initiative activityorc initiatives comments list— List Initiative commentsorc initiatives comments create— Comment on an Initiativeorc initiatives favorites enable— Favorite an Initiativeorc initiatives favorites disable— Unfavorite an Initiativeorc initiatives restore— Restore an Initiativeorc initiatives subscriptions enable— Subscribe to an Initiativeorc initiatives subscriptions disable— Unsubscribe from an Initiativeorc initiatives updates list— List Initiative Updatesorc initiatives updates create— Post an Initiative Updateorc initiatives batch update— Batch update Initiatives
orc initiatives list
List workspace initiatives
Usage
orc initiatives list [flags]Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--tab | string | No | enum: active|planned|all |
--status | string | No | enum: proposed|planned|active|completed|canceled |
--sort | string | No | enum: created_at|target_date|manual |
--order | string | No | enum: asc|desc |
--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.
Help
orc initiatives list --helporc initiatives create
Create a workspace initiative
Usage
orc initiatives 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. |
--color | string | No | Body field: color; max 100 chars |
--description | string | No | Body field: description; max 2000 chars |
--icon | string | No | Body field: icon; max 100 chars |
--labels | string | No | Body field: labels; csv |
--name | string | No | (required) Body field: name; max 200 chars |
--owner-id | string | No | Body field: owner_id |
--priority | string | No | Body field: priority; enum: urgent|high|medium|low| |
--status | string | No | Body field: status; enum: proposed|planned|active|completed|canceled |
--target-date | string | No | Body field: target_date |
--target-precision | string | No | Body field: target_precision; enum: day|month|quarter|half_year|year| |
See global flags for output and request options. Use --help to check the flags supported by this command.
Help
orc initiatives create --helporc initiatives get
Get an initiative
Usage
orc initiatives get <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Help
orc initiatives get --helporc initiatives update
Update an initiative
Usage
orc initiatives update <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--color | string | No | Body field: color; max 100 chars |
--description | string | No | Body field: description; max 2000 chars |
--icon | string | No | Body field: icon; max 100 chars |
--labels | string | No | Body field: labels; csv |
--name | string | No | Body field: name; max 200 chars |
--owner-id | string | No | Body field: owner_id |
--priority | string | No | Body field: priority; enum: urgent|high|medium|low| |
--rank | string | No | Body field: rank; max 100 chars |
--status | string | No | Body field: status; enum: proposed|planned|active|completed|canceled |
--target-date | string | No | Body field: target_date |
--target-precision | string | No | Body field: target_precision; enum: day|month|quarter|half_year|year| |
--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.
Help
orc initiatives update --helporc initiatives delete
Soft-delete an Initiative
Usage
orc initiatives delete <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative delete
Help
orc initiatives delete --helporc initiatives rollup get
Get initiative progress rollup
Usage
orc initiatives rollup get <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Help
orc initiatives rollup get --helporc initiatives projects list
List Initiative Projects
Usage
orc initiatives projects list <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--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.
Help
orc initiatives projects list --helporc initiatives projects create
Add a Project to an Initiative
Usage
orc initiatives projects create <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--project-id | string | No | (required) Body field: project_id |
--rank | number | No | Body field: rank |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiatives projects add
Help
orc initiatives projects create --helporc initiatives projects update
Reorder an Initiative Project
Usage
orc initiatives projects update <id> <project-id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
project-id | Yes | Project ID. |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--rank | number | No | (required) Body field: rank |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiatives projects reorder
Help
orc initiatives projects update --helporc initiatives projects delete
Remove a Project from an Initiative
Usage
orc initiatives projects delete <id> <project-id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
project-id | Yes | Project ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiatives projects remove
Help
orc initiatives projects delete --helporc initiatives activity list
List Initiative activity
Usage
orc initiatives activity list <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative activity
Help
orc initiatives activity list --helporc initiatives comments list
List Initiative comments
Usage
orc initiatives comments list <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative comments
Help
orc initiatives comments list --helporc initiatives comments create
Comment on an Initiative
Usage
orc initiatives comments create <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative 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 initiative comment
Help
orc initiatives comments create --helporc initiatives favorites enable
Favorite an Initiative
Usage
orc initiatives favorites enable <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative favorite
Help
orc initiatives favorites enable --helporc initiatives favorites disable
Unfavorite an Initiative
Usage
orc initiatives favorites disable <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative unfavorite
Help
orc initiatives favorites disable --helporc initiatives restore
Restore an Initiative
Usage
orc initiatives restore <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative restore
Help
orc initiatives restore --helporc initiatives subscriptions enable
Subscribe to an Initiative
Usage
orc initiatives subscriptions enable <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative subscribe
Help
orc initiatives subscriptions enable --helporc initiatives subscriptions disable
Unsubscribe from an Initiative
Usage
orc initiatives subscriptions disable <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative unsubscribe
Help
orc initiatives subscriptions disable --helporc initiatives updates list
List Initiative Updates
Usage
orc initiatives updates list <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative updates
Help
orc initiatives updates list --helporc initiatives updates create
Post an Initiative Update
Usage
orc initiatives updates create <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Initiative ID. |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--body | string | No | (required) Body field: body; max 10000 chars |
--health | string | No | (required) Body field: health; enum: on_track|at_risk|off_track |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc initiative update
Help
orc initiatives updates create --helporc initiatives batch update
Batch update Initiatives
Usage
orc initiatives 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.
Help
orc initiatives batch update --help