Update a feedback record

PATCH/v1/feedback-records/{id}

Updates specific fields of a feedback record data point

Path ParametersExpand Collapse

id: string

Feedback Record ID (UUID)

formatuuid

Body ParametersExpand Collapse

language: optional string

Update language. NULL bytes not allowed.

maxLength10

metadata: optional map[unknown]

Update metadata. NULL bytes (\x00 or \u0000) are not allowed in JSON keys or values.

user_identifier: optional string

Update user identifier

value_boolean: optional boolean

Update boolean response

value_date: optional string

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

formatdate-time

value_number: optional number

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

formatdouble

minimum-1000000000000000

maximum1000000000000000

value_text: optional string

Update text response. NULL bytes not allowed.

ReturnsExpand Collapse

FeedbackRecordData = object { id, collected_at, created_at, 17 more }

id: string

UUIDv7 primary key

formatuuid

collected_at: string

When the feedback was collected

formatdate-time

created_at: string

When this record was created

formatdate-time

field_id: string

Identifier for the question/field

field_type: string

Type of field

source_type: string

Type of feedback source

updated_at: string

When this record was last updated

formatdate-time

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 map[unknown]

Additional context

source_id: optional string

Reference to survey/form/ticket ID

source_name: optional string

Human-readable name

tenant_id: optional string

Tenant/organization identifier. NULL bytes not allowed.

user_identifier: optional string

User identifier

value_boolean: optional boolean

Boolean response

value_date: optional string

Date response

formatdate-time

value_number: optional number

Numeric response

formatdouble

value_text: optional string

Text response. NULL bytes not allowed.

Update a feedback record

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

{
  "id": "018e1234-5678-9abc-def0-123456789abc",
  "collected_at": "2024-01-15T10:30:00Z",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T11:00:00Z",
  "source_type": "survey",
  "field_id": "q1",
  "field_type": "rating",
  "field_label": "How satisfied are you?",
  "value_number": 10,
  "source_id": "survey-123",
  "source_name": "Q1 NPS Survey",
  "user_identifier": "user-abc-123",
  "tenant_id": "org-123",
  "language": "en",
  "metadata": {
    "tags": [
      "important",
      "follow-up"
    ]
  }
}

{
  "type": "about:blank",
  "title": "Not Found",
  "status": 404,
  "detail": "Feedback record with ID '018e1234-5678-9abc-def0-123456789abc' not found",
  "instance": "/v1/feedback-records/018e1234-5678-9abc-def0-123456789abc"
}

Returns Examples

{
  "id": "018e1234-5678-9abc-def0-123456789abc",
  "collected_at": "2024-01-15T10:30:00Z",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T11:00:00Z",
  "source_type": "survey",
  "field_id": "q1",
  "field_type": "rating",
  "field_label": "How satisfied are you?",
  "value_number": 10,
  "source_id": "survey-123",
  "source_name": "Q1 NPS Survey",
  "user_identifier": "user-abc-123",
  "tenant_id": "org-123",
  "language": "en",
  "metadata": {
    "tags": [
      "important",
      "follow-up"
    ]
  }
}

{
  "type": "about:blank",
  "title": "Not Found",
  "status": 404,
  "detail": "Feedback record with ID '018e1234-5678-9abc-def0-123456789abc' not found",
  "instance": "/v1/feedback-records/018e1234-5678-9abc-def0-123456789abc"
}