--- title: feedbacks description: Submit product feedback and bug reports. canonical_url: https://orchestor.io/docs/en/cli/feedback markdown_url: https://orchestor.io/docs/en/cli/feedback.md contentType: reference --- # feedbacks `orc feedbacks` submits product feedback or bug reports with a category, message, and reproduction context. Normally it uses the active profile and Workspace; a Workspace `owner` can list submitted feedback. Use `--anonymous` to report a problem such as a failed login when authentication is unavailable. Anonymous submissions do not resolve or send saved credentials or a Workspace and do not support attachments. ## Usage ```bash title="terminal" orc feedbacks create --anonymous --category slow-or-broken --message "Login does not complete." --json ``` *Report a problem anonymously when authentication is unavailable.* ## Subcommands ### `list` Reads back feedback for the Workspace. Listing requires the Workspace `owner` role. ```bash title="terminal" orc feedbacks list [options] ``` ### `create` Submits a report with a category. `category` is `inaccurate`, `instruction-not-followed`, `out-of-scope`, `typo`, `slow-or-broken`, or `other`. Messages are limited to 2000 characters; you can include a conversation ID or JSON `client_context`. Screenshots use existing Files IDs; inline images and base64 payloads are not accepted. ```bash title="terminal" orc feedbacks create [options] ``` #### Unique options ##### `--idempotency-key` 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. Type: `string`. Optional. ```bash title="terminal" orc feedbacks create --idempotency-key ``` ##### `--category` (required) Body field: category; enum: inaccurate|instruction-not-followed|out-of-scope|typo|slow-or-broken|other Type: `string`. Optional. ```bash title="terminal" orc feedbacks create --category ``` ##### `--message` Description of the problem. Leading and trailing whitespace is removed; the trimmed message must contain at most 2000 characters. Omission or a blank string stores an empty message. Sensitive patterns are redacted before storage.; max 2000 chars Type: `string`. Optional. ```bash title="terminal" orc feedbacks create --message ``` ##### `--conversation-id` Conversation reference supplied by the caller. Whitespace is trimmed; omission, null or a blank string stores no reference. This field does not fetch conversation contents.; (use "null" or "reset" to clear) Type: `string`. Optional. ```bash title="terminal" orc feedbacks create --conversation-id ``` ##### `--screenshot-file-ids` Up to three distinct files-domain IDs for completed screenshot uploads in the authenticated workspace. IDs are trimmed and deduplicated. Omission attaches no files. Anonymous submissions cannot attach screenshots. Files must use the screenshot purpose and pass the screenshot upload policy; inline images and base64 payloads are not accepted.; csv Type: `string`. Optional. ```bash title="terminal" orc feedbacks create --screenshot-file-ids ``` ##### `--client-context` Optional diagnostic context. Omission stores an empty object. Only surface, url, route, viewport, user_agent, app_revision, locale and theme are retained; other keys are discarded. surface accepts authed-sidebar or public-sidebar. Other values must be nonblank strings. URLs must use HTTP or HTTPS; credentials, query and fragment are removed. Routes lose query and fragment. Text whitespace is normalized. Values are truncated to 2048 characters for url, 512 for route and user_agent, 32 for viewport, 128 for app_revision, and 64 for locale and theme.; (JSON object, e.g. '{"custom_id":"x"}') Type: `string`. Optional. ```bash title="terminal" orc feedbacks create --client-context ``` ## Examples ### Submit reproduction context from a file. ```bash title="terminal" orc feedbacks create --stdin < feedback.json --json ``` *Submit reproduction context from a file.* ## Anonymous submission constraints You cannot combine `--anonymous` with `--workspace`, credential selectors, or `--screenshot-file-ids`. Do not include screenshot IDs in an anonymous JSON body either. A failed authenticated submission does not automatically fall back to anonymous submission. ## Report a workflow failure [Report a failure and verify the fix](https://orchestor.io/docs/cli/workflows/workflow-feedback.md) covers reproduction details, `--stdin` submission, keeping receipt IDs, and verification after a fix. ## Global Options The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc feedbacks`: - [`--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) - [`--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) - [`--anonymous`](https://orchestor.io/docs/cli/global-flags.md) - [`--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)