## Update

**patch** `/v1/feedback-records/{id}`

Updates specific fields of a feedback record data point.

Changing `value_text` clears the server-generated enrichment fields computed from it
(`sentiment`, `sentiment_score`, `emotions`, `value_text_translated`,
`translation_lang_key`) and queues re-enrichment; changing `language` clears and
re-queues the translation pair only. The response reflects the cleared state — the
fields are absent until the asynchronous re-enrichment completes.

### Path Parameters

- `id: string`

  Feedback Record ID (UUID)

### Body Parameters

- `language: optional string`

  Update language. NULL bytes not allowed.

- `metadata: optional map[unknown]`

  Replaces the stored metadata object **wholesale** — it is not merged, so send every key you want to keep or the omitted ones are lost. See the create operation for the value rules and key conventions, including the same 400 rejections (invalid UTF-8, NULL bytes, unpaired surrogates, out-of-range numbers).

- `user_id: optional string`

  User ID (e.g., anonymous ID or email hash)

- `value_boolean: optional boolean`

  Update boolean response

- `value_date: optional string`

  Update date response. Must be between 1970-01-01 and 2080-12-31.

- `value_id: optional string`

  Update the stable id of the selected option in the source system (e.g. a survey choice id), stored alongside value_text for durable option identity. Opaque to Hub. NULL bytes not allowed.

- `value_number: optional number`

  Update numeric response. Must be between -1e15 and +1e15.

- `value_text: optional string`

  Update text response. NULL bytes not allowed.

### Returns

- `FeedbackRecordData = object { id, collected_at, created_at, 24 more }`

  - `id: string`

    UUIDv7 primary key

  - `collected_at: string`

    When the feedback was collected

  - `created_at: string`

    When this record was created

  - `field_id: string`

    Identifier for the question/field

  - `field_type: "text" or "categorical" or "nps" or 6 more`

    Type of field

    - `"text"`

    - `"categorical"`

    - `"nps"`

    - `"csat"`

    - `"ces"`

    - `"rating"`

    - `"number"`

    - `"boolean"`

    - `"date"`

  - `source_type: string`

    Type of feedback source

  - `submission_id: string`

    Identifier for the logical submission this record belongs to (required).

  - `tenant_id: string`

    Tenant/organization identifier. NULL bytes not allowed.

  - `updated_at: string`

    When this record was last updated

  - `emotions: optional array of "joy" or "anger" or "sadness" or 3 more`

    Emotions inferred from value_text (emotion enrichment); multi-label from a fixed set. Read-only; absent until the record is enriched, and never an empty array.

    - `"joy"`

    - `"anger"`

    - `"sadness"`

    - `"fear"`

    - `"surprise"`

    - `"disgust"`

  - `field_group_id: optional string`

    Stable identifier grouping related fields (for ranking, matrix, grid questions)

  - `field_group_label: optional string`

    Human-readable question text for the group

  - `field_label: optional string`

    The actual question text

  - `language: optional string`

    ISO language code. NULL bytes not allowed.

  - `metadata: optional unknown or array of unknown or string or 2 more`

    Arbitrary context stored with this record, returned with equivalent values (key order is normalized, and so are number exponents — `1e2` reads back as `100`). Omitted when the record has no metadata; a record explicitly stored with a JSON `null` returns `null`.
    An object is the supported shape and the only one the request schemas accept. The wider union is for reading: the column stores whatever JSON was written, so a record created before that convention can return an array or a scalar, and an object-only response schema would make a generated client reject it.

    - `UnionMember0 = unknown`

      Arbitrary context stored with this record, returned with equivalent values (key order is normalized, and so are number exponents — `1e2` reads back as `100`). Omitted when the record has no metadata; a record explicitly stored with a JSON `null` returns `null`.
      An object is the supported shape and the only one the request schemas accept. The wider union is for reading: the column stores whatever JSON was written, so a record created before that convention can return an array or a scalar, and an object-only response schema would make a generated client reject it.

    - `UnionMember1 = array of unknown`

      Arbitrary context stored with this record, returned with equivalent values (key order is normalized, and so are number exponents — `1e2` reads back as `100`). Omitted when the record has no metadata; a record explicitly stored with a JSON `null` returns `null`.
      An object is the supported shape and the only one the request schemas accept. The wider union is for reading: the column stores whatever JSON was written, so a record created before that convention can return an array or a scalar, and an object-only response schema would make a generated client reject it.

    - `UnionMember2 = string`

      Arbitrary context stored with this record, returned with equivalent values (key order is normalized, and so are number exponents — `1e2` reads back as `100`). Omitted when the record has no metadata; a record explicitly stored with a JSON `null` returns `null`.
      An object is the supported shape and the only one the request schemas accept. The wider union is for reading: the column stores whatever JSON was written, so a record created before that convention can return an array or a scalar, and an object-only response schema would make a generated client reject it.

    - `UnionMember3 = number`

      Arbitrary context stored with this record, returned with equivalent values (key order is normalized, and so are number exponents — `1e2` reads back as `100`). Omitted when the record has no metadata; a record explicitly stored with a JSON `null` returns `null`.
      An object is the supported shape and the only one the request schemas accept. The wider union is for reading: the column stores whatever JSON was written, so a record created before that convention can return an array or a scalar, and an object-only response schema would make a generated client reject it.

    - `UnionMember4 = boolean`

      Arbitrary context stored with this record, returned with equivalent values (key order is normalized, and so are number exponents — `1e2` reads back as `100`). Omitted when the record has no metadata; a record explicitly stored with a JSON `null` returns `null`.
      An object is the supported shape and the only one the request schemas accept. The wider union is for reading: the column stores whatever JSON was written, so a record created before that convention can return an array or a scalar, and an object-only response schema would make a generated client reject it.

  - `sentiment: optional "very_negative" or "negative" or "neutral" or 3 more`

    Sentiment polarity inferred from value_text (sentiment enrichment). Read-only; absent until the record is enriched.

    - `"very_negative"`

    - `"negative"`

    - `"neutral"`

    - `"positive"`

    - `"very_positive"`

    - `"mixed"`

  - `sentiment_score: optional number`

    Signed sentiment polarity from -1.0 (very negative) to 1.0 (very positive) (sentiment enrichment). Read-only; absent until the record is enriched.

  - `source_id: optional string`

    Reference to survey/form/ticket ID

  - `source_name: optional string`

    Human-readable name

  - `translation_lang_key: optional string`

    BCP-47 target locale that value_text_translated was produced in (language enrichment). Read-only; absent until the record is enriched.

  - `user_id: optional string`

    User ID (e.g., anonymous ID or email hash)

  - `value_boolean: optional boolean`

    Boolean response

  - `value_date: optional string`

    Date response

  - `value_id: optional string`

    Stable id of the selected option in the source system (e.g. a survey choice id), stored alongside value_text for durable option identity. Opaque to Hub. Absent for free-text/non-choice answers. NULL bytes not allowed.

  - `value_number: optional number`

    Numeric response

  - `value_text: optional string`

    Text response. NULL bytes not allowed.

  - `value_text_translated: optional string`

    value_text translated into the tenant's configured target language (language enrichment). Read-only; absent until the record is enriched.

### Example

```http
curl http://localhost:8080/v1/feedback-records/$ID \
    -X PATCH \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $HUB_API_KEY" \
    -d '{}'
```