---
title: "Create Surface Feedback"
method: POST
path: "/api/v1/a2ui/surfaces/{surface_id}/feedback"
tags: ["A 2 UI"]
---

# Create Surface Feedback

`POST /api/v1/a2ui/surfaces/{surface_id}/feedback`

CreateSurfaceFeedback submits feedback for a surface with a snapshot.

## Path parameters

- `surface_id` string, required — The surfaceId field.

## Request body

- C1ApiA2uiV1A2UIServiceCreateSurfaceFeedbackRequestInput — A2UIServiceCreateSurfaceFeedbackRequest creates feedback for a surface.
  - `conversationId` string — The conversationId field.
  - `sentiment` 'A2UI_SURFACE_FEEDBACK_SENTIMENT_UNSPECIFIED' | 'A2UI_SURFACE_FEEDBACK_SENTIMENT_POSITIVE' | 'A2UI_SURFACE_FEEDBACK_SENTIMENT_NEGATIVE' — The sentiment field.
  - `text` string — The text field.

## Response `200`

A2UIServiceCreateSurfaceFeedbackResponse returns the created feedback.

- C1ApiA2uiV1A2UIServiceCreateSurfaceFeedbackResponse — A2UIServiceCreateSurfaceFeedbackResponse returns the created feedback.
  - `feedback` C1ApiA2uiV1A2UISurfaceFeedback — A2UISurfaceFeedback represents user feedback for a surface.
    - `actionName` string — The actionName field.
    - `componentsSnapshot` string — The componentsSnapshot field.
    - `conversationId` string — The conversationId field.
    - `createdAt` string, date-time, nullable
    - `dataModelSnapshot` string — The dataModelSnapshot field.
    - `id` string — The id field.
    - `schemaVersion` string, int64 — The schemaVersion field.
    - `sentiment` 'A2UI_SURFACE_FEEDBACK_SENTIMENT_UNSPECIFIED' | 'A2UI_SURFACE_FEEDBACK_SENTIMENT_POSITIVE' | 'A2UI_SURFACE_FEEDBACK_SENTIMENT_NEGATIVE' — The sentiment field.
    - `surfaceId` string — The surfaceId field.
    - `text` string — The text field.

## Changes

- **2026-08-21** `f2cf3228f366` — 2 breaking, 10 warning
  - added `#/components/schemas/c1.api.a2ui.v1.A2UISurfaceFeedback, subschema #2` to the `feedback` response property `oneOf` list for the response status `200`
  - the `feedback` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `feedback/actionName` from the response with the `200` status
  - removed the optional property `feedback/componentsSnapshot` from the response with the `200` status
  - …8 more
- **2026-04-30** `fa2bb307d6fa` — 1 info
  - added the optional property `feedback/componentsSnapshot` to the response with the `200` status
- **2026-03-10** `7fa698b04b81` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/a2ui/surfaces/:surface_id/feedback/post.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)