--- title: perception-attributes description: Create, rename, and hide perception attributes. canonical_url: https://orchestor.io/docs/en/cli/perception-attributes markdown_url: https://orchestor.io/docs/en/cli/perception-attributes.md contentType: reference --- # perception-attributes `orc perception-attributes` manages observed and custom brand attributes. Add attributes for future observations, rename display labels, or hide attributes from reports and source evidence. Supply a brand ID in the target Workspace. IDs returned for observed attributes by `list` can be used directly for update or delete. Renaming or hiding retains historical observations and the original `source_label`. ## Usage ```bash title="terminal" orc perception-attributes list --brand-id ``` *Retrieve brand attributes.* ## Subcommands ### `list` List observed and custom attributes. An unavailable target brand returns 404. ```bash title="terminal" orc perception-attributes list [options] ``` #### Unique options ##### `--brand-id` Brand identifier in the selected workspace. Required; an unavailable brand returns 404. Type: `string`. Required. ```bash title="terminal" orc perception-attributes list --brand-id ``` ### `create` Create up to 10 active custom attributes per brand. Labels must contain 2–80 characters after Unicode NFKC normalization, trimming, and collapsing whitespace. Use an idempotency key for retries. ```bash title="terminal" orc perception-attributes 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 perception-attributes create --idempotency-key ``` ##### `--brand-id` (required) Required brand in the selected workspace. Whitespace is trimmed. Type: `string`. Optional. ```bash title="terminal" orc perception-attributes create --brand-id ``` ##### `--label` (required) Display label after Unicode NFKC normalization, trimming and whitespace collapsing. Must contain 2–80 characters after normalization.; max 80 chars Type: `string`. Optional. ```bash title="terminal" orc perception-attributes create --label ``` ### `update` Rename a persisted or observed attribute. Label normalization and the 2–80 character requirement match creation. Original source labels and existing evidence associations remain intact. ```bash title="terminal" orc perception-attributes update [options] ``` #### Unique options ##### `--brand-id` (required) Required brand in the selected workspace. Whitespace is trimmed. Type: `string`. Optional. ```bash title="terminal" orc perception-attributes update --brand-id ``` ##### `--label` (required) Display label after Unicode NFKC normalization, trimming and whitespace collapsing. Must contain 2–80 characters after normalization.; max 80 chars Type: `string`. Optional. ```bash title="terminal" orc perception-attributes update --label ``` ### `delete` Hide an attribute from reports and source evidence. Historical observations and source labels remain. Pass `--yes` to skip confirmation non-interactively. ```bash title="terminal" orc perception-attributes delete [options] ``` #### Unique options ##### `--brand-id` Brand identifier in the selected workspace. Required; an unavailable brand returns 404. Type: `string`. Required. ```bash title="terminal" orc perception-attributes delete --brand-id ``` ## Examples ### Add a custom attribute. ```bash title="terminal" orc perception-attributes create --brand-id --label "Customer support" ``` *Add a custom attribute.* ### Rename the display label. ```bash title="terminal" orc perception-attributes update --brand-id --label "Support quality" ``` *Rename the display label.* ## 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 perception-attributes`: - [`--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)