topics
This page is the command reference for @orchestor-inc/cli.
Commands
orc topics list— List AI Search topics in projectorc topics create— Create AI Search topicorc topics get— Get AI Search topicorc topics update— Update AI Search topicorc topics delete— Soft-delete AI Search topicorc topics suggestions list— List topic suggestionsorc topics suggestions refresh— Generate topic suggestionsorc topics suggestions generations get— Get topic suggestion generationorc topics suggestions accept— Accept a topic suggestion (promote to topic)orc topics suggestions reject— Reject a topic suggestion
orc topics list
List AI Search topics in project
Usage
orc topics list [flags]Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--brand-id | string | No | Optional AI Search Brand ID filter. |
--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 topic list
Help
orc topics list --helporc topics create
Create AI Search topic
Usage
orc topics 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. |
--name | string | No | (required) Topic name.; max 255 chars |
--brand-id | string | No | Optional brand association. Required by the current storage model until nullable project-only topics are enabled. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Help
orc topics create --helporc topics get
Get AI Search topic
Usage
orc topics 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 topic get
Help
orc topics get --helporc topics update
Update AI Search topic
Usage
orc topics update <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Path parameter: id |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--name | string | No | Body field: name; max 255 chars |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc topic update
Help
orc topics update --helporc topics delete
Soft-delete AI Search topic
Usage
orc topics 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 topic delete
Help
orc topics delete --helporc topics suggestions list
List topic suggestions
Usage
orc topics suggestions list [flags]Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--status | string | No | enum: pending|accepted|rejected |
--brand-id | string | No | value |
--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 topic suggestion-list
Help
orc topics suggestions list --helporc topics suggestions refresh
Generate topic suggestions
Usage
orc topics suggestions refresh [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. |
--wait | boolean | No | Wait for an asynchronous operation to finish and print its result |
--timeout | string | No | Maximum wait duration (for example 30s or 5m) |
--poll-interval | string | No | Delay between status requests (default: 5s) Default: 5s |
See global flags for output and request options. Use --help to check the flags supported by this command.
Help
orc topics suggestions refresh --helporc topics suggestions generations get
Get topic suggestion generation
Usage
orc topics suggestions generations 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 topics suggestions generations get --helporc topics suggestions accept
Accept a topic suggestion (promote to topic)
Usage
orc topics suggestions accept <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Path parameter: id |
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. |
--brand-id | string | No | Override target brand |
--edit-name | string | No | Body field: edit_name; max 255 chars |
See global flags for output and request options. Use --help to check the flags supported by this command.
Help
orc topics suggestions accept --helporc topics suggestions reject
Reject a topic suggestion
Usage
orc topics suggestions reject <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Path parameter: id |
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. |
See global flags for output and request options. Use --help to check the flags supported by this command.
Help
orc topics suggestions reject --help