--- title: answers description: Retrieve persisted AI answers and record exports. canonical_url: https://orchestor.io/docs/en/cli/answer markdown_url: https://orchestor.io/docs/en/cli/answer.md contentType: reference --- # answers `orc answers` lists and retrieves persisted AI answers. Inspect answers by prompt, topic, monitored brand, measurement channel, execution context, time range, and sentiment. The export operation records a CSV generated by the client. The target is answers in the selected Workspace. To measure new answers, use [`orc runs`](https://orchestor.io/docs/en/cli/runs.md). `answer` is a compatibility alias for the same operations. ## Usage ```bash title="terminal" orc answers list --workspace ``` *List persisted answers.* ## Filter semantics `--brand-id` selects the monitored brand owning the prompt, not any brand mentioned in an answer. `--platform` exactly matches a stored channel ID. Persona is an execution-time value rather than a Persona resource ID lookup; region uses execution, prompt, or snapshot locale, not Workspace residency. `--tag` matches active Workspace tag names case-insensitively; supply a name, not an ID. Stored execution tags take precedence, otherwise current prompt tags are used. `--brand-mentioned` filters by whether the stored mentions array is nonempty; it can differ from the derived `brand_mentioned` response. Sentiment uses a stored label or numeric score; unscored answers do not match. ## Subcommands ### `list` Defaults to descending `created_at`, with answer ID breaking ties. Prompt text sorting and ascending order are also available. Retain sort, order, and filters while following cursors. `--start-date` is an inclusive UTC timestamp; `--end-date` is exclusive. ```bash title="terminal" orc answers list [options] ``` #### Unique options ##### `--prompt-id` Return answers for this prompt ID. Omit to include all accessible prompts. Type: `string`. Optional. ```bash title="terminal" orc answers list --prompt-id ``` ##### `--topic-id` Return answers associated with this topic through the current prompt or its saved observation snapshot. Type: `string`. Optional. ```bash title="terminal" orc answers list --topic-id ``` ##### `--brand-id` Return answers whose topic belongs to this monitored brand. This selects the target brand, not a brand mentioned anywhere in the answer. Type: `string`. Optional. ```bash title="terminal" orc answers list --brand-id ``` ##### `--platform` Exact stored observation-channel filter, such as chatgpt-ui. Omit to include all channels. Type: `string`. Optional. ```bash title="terminal" orc answers list --platform ``` ##### `--persona` Exact persona value stored in the original execution request. This is not a Persona resource ID lookup. Type: `string`. Optional. ```bash title="terminal" orc answers list --persona ``` ##### `--region` Observation country or region, matched without case sensitivity. The server uses the execution request, then prompt or saved snapshot locale; this is not workspace residency. Type: `string`. Optional. ```bash title="terminal" orc answers list --region ``` ##### `--tag` Tag name, matched without case sensitivity among active workspace tags. Stored request tag IDs take precedence; otherwise current prompt tags are used. Supply a name, not an ID. Type: `string`. Optional. ```bash title="terminal" orc answers list --tag ``` ##### `--prompt-type` Exact free-form prompt_type stored in the execution request or saved observation snapshot. Omit to include every type. Type: `string`. Optional. ```bash title="terminal" orc answers list --prompt-type ``` ##### `--brand-mentioned` Filter by whether the stored answer mentions array is nonempty (true) or empty/missing (false). This filter is based on stored mentions and can differ from the derived brand_mentioned response field. Type: `string`. Optional. ```bash title="terminal" orc answers list --brand-mentioned ``` ##### `--sentiment` Filter by the stored analysis label. If a label is absent, positive and negative numeric scores map to their respective labels and zero maps to neutral. Unscored answers do not match.; enum: positive|neutral|negative Type: `string`. Optional. ```bash title="terminal" orc answers list --sentiment ``` ##### `--start-date` Inclusive lower bound on `created_at` as a UTC date-time. Type: `string`. Optional. ```bash title="terminal" orc answers list --start-date ``` ##### `--end-date` Exclusive upper bound on `created_at` as a UTC date-time. Type: `string`. Optional. ```bash title="terminal" orc answers list --end-date ``` ##### `--sort` Sort by creation time (default) or prompt text. The answer ID breaks ties. Keep the same sort and filters while following a cursor.; enum: prompt|created_at Type: `string`. Optional. ```bash title="terminal" orc answers list --sort ``` ##### `--order` Sort direction for the selected field and ID tie-breaker. Defaults to desc. Keep this value unchanged while paging.; enum: asc|desc Type: `string`. Optional. ```bash title="terminal" orc answers list --order ``` ### `exports create` Record a client-generated file export using `--export-format csv` and `--row-count`. The server does not generate the answer CSV or verify its rows or actual row count. ```bash title="terminal" orc answers exports create [options] ``` #### Unique options ##### `--export-format` (required) Client-generated export format. Only csv is accepted.; enum: csv Type: `string`. Optional. ```bash title="terminal" orc answers exports create --export-format ``` ##### `--row-count` (required) Number of rows in the client-generated file. Validated as request metadata; the server does not generate or verify the exported rows. Type: `number`. Optional. ```bash title="terminal" orc answers exports create --row-count ``` ### `get` Retrieve a persisted answer using the answer row ID (`PromptAnswerData.id`) returned by listing. Distinguish it from a run ID. ```bash title="terminal" orc answers get [options] ``` ## Examples ### Filter by one channel and prompt. ```bash title="terminal" orc answers list --prompt-id --platform chatgpt-ui --json ``` *Filter by one channel and prompt.* ### Retrieve answer details. ```bash title="terminal" orc answers get --json ``` *Retrieve answer details.* ### Record an already generated CSV export. ```bash title="terminal" orc answers exports create --export-format csv --row-count 20 ``` *Record an already generated CSV export.* ## Permissions Authenticate and select the target Workspace. Access to that Workspace is required. ## Global Options The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc answers`: - [`--help`](https://orchestor.io/docs/cli/global-flags.md#help) - [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace) - [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output) - [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output) - [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format) - [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection) - [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection) - [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output) - [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output) - [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager) - [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run) - [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation) - [`--limit`](https://orchestor.io/docs/cli/global-flags.md) - [`--cursor`](https://orchestor.io/docs/cli/global-flags.md) - [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input) - [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input) - [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages) - [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing) - [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode) - [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping) For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md). --- [Documentation index](https://orchestor.io/docs/llms.txt)