> ## Documentation Index > Fetch the complete documentation index at: https://docs.tied.com/llms.txt > Use this file to discover all available pages before exploring further. # Submit a CSAT rating > Records the contact's rating and comment. Unauthenticated, like the read. A contact may change their answer, but only for **fourteen days** from when the survey was sent; after that the request returns a 422 with `You cannot update the CSAT survey after 14 days`. The window is measured from the survey message's `created_at`, not from when it was first answered. ## OpenAPI ````yaml /api-reference/openapi.json patch /public/api/v1/csat_survey/{id} openapi: 3.0.4 info: title: Tied API description: >- The Tied REST API. Three families of endpoint, each with its own credential: **Application** for everything inside an account, **Platform** for provisioning accounts and users, and **Client** for acting as a contact from your own surface. version: 1.1.0 termsOfService: https://tied.com/legal contact: email: hello@tied.com license: name: MIT License url: https://opensource.org/licenses/MIT servers: - url: https://app.tied.com description: Tied cloud security: [] tags: - name: Account AgentBots description: Account-specific Agent Bots - name: Agents description: Agent management APIs - name: Canned Responses description: Pre-defined responses for common queries - name: Contacts description: Contact management APIs - name: Contact Labels description: Manage contact labels - name: Conversation Assignments description: Manage conversation assignments - name: Conversation Labels description: Manage conversation labels - name: Conversations description: Conversation management APIs - name: Custom Attributes description: Custom fields for contacts and conversations - name: Custom Filters description: Saved filters for conversations - name: Inboxes description: Communication channels setup - name: Integrations description: Third-party integrations - name: Messages description: Message management APIs - name: Profile description: User profile APIs - name: Reports description: Analytics and reporting APIs - name: Teams description: Team management APIs - name: Webhooks description: Event notification webhooks - name: Automation Rule description: Workflow automation rules - name: Help Center description: Knowledge base management - name: Contacts API description: Public contact APIs - name: Conversations API description: Public conversation APIs - name: Messages API description: Public message APIs - name: CSAT Survey Page description: Customer satisfaction survey - name: Account description: >- The authenticated user's own account — read and update account settings. Distinct from the Platform family's **Accounts**, which provisions accounts across an installation. - name: Audit Logs description: Read the account's audit trail - name: Inbox API description: Public inbox lookup by channel identifier - name: Labels description: >- Create and manage the account's labels. Applying one to a conversation or contact is a separate endpoint under those resources. - name: Macros description: >- Saved multi-step actions an agent — or an integration — can run against one or more conversations. - name: Campaigns description: Ongoing website campaigns and one-off SMS and WhatsApp sends. - name: Contact Notes description: Internal notes on a contact. Never visible to the contact. - name: Help Center Categories description: Categories group a portal's articles, one tree per allowed locale. - name: Help Center Articles description: The articles a portal publishes, and their draft and archived states. - name: Summary Reports description: Per-agent, per-team, per-inbox and per-label totals for a period, as JSON. - name: Live Reports description: Right-now queue counts. No date range — these describe the present. - name: CSAT description: >- The satisfaction ratings contacts have submitted, and the metrics computed from them. - name: Notifications description: >- The per-user notification feed, its read and snooze state, and the settings that decide what lands in it. - name: Conversation Participants description: >- The agents watching a conversation. Participants get notified about it without being assigned to it. - name: Draft Messages description: >- The unsent reply held for a conversation. Stored in Redis, one per conversation. - name: Search description: >- One search service across conversations, contacts, messages and Help Center articles. - name: Dashboard Apps description: Embedded pages that appear as a tab beside a conversation. - name: Assignment Policies description: How conversations are handed out, and which inbox uses which policy. - name: Files description: Storing a file so another endpoint can attach it. - name: Bot Flows description: >- Scripted conversation flows, their versions, and the publish and rollback that move between them. - name: Billing description: >- Credit balance, usage, invoices, spend controls and the provider-hosted payment flows. - name: AMB Templates description: >- Saved Apple Messages primitive payloads an agent can reuse from the composer. - name: AMB Onboarding description: The in-flight Apple Messages for Business registration for an account. - name: Widget Session description: Starting a widget session and reading the visitor it belongs to. - name: Widget Conversation description: The visitor's conversation and its messages. - name: Widget Context description: Campaigns, agents, labels, events and uploads for a widget session. - name: CSAT Survey description: The public, unauthenticated survey a contact answers from a link. - name: Workspace description: Scheduling and cancelling deletion of the whole workspace. paths: /public/api/v1/csat_survey/{id}: patch: tags: - CSAT Survey summary: Submit a CSAT rating description: >- Records the contact's rating and comment. Unauthenticated, like the read. A contact may change their answer, but only for **fourteen days** from when the survey was sent; after that the request returns a 422 with `You cannot update the CSAT survey after 14 days`. The window is measured from the survey message's `created_at`, not from when it was first answered. operationId: submit-public-csat-survey parameters: - name: id in: path required: true description: The conversation UUID. schema: type: string example: 00000000-0000-0000-0000-000000000000 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/public_csat_update_payload' example: message: submitted_values: csat_survey_response: rating: 4 feedback_message: Quick and clear, thank you. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/public_csat_message' example: id: 1200 csat_survey_response: id: 29 account_id: 1 conversation_id: 338 message_id: 1200 rating: 5 feedback_message: >- Sorted in one reply, and the agent explained why it happened. Ideal. contact_id: 262 assigned_agent_id: null created_at: '2026-09-21T04:05:21.113Z' updated_at: '2026-09-21T04:05:21.113Z' display_type: emoji content: null inbox_avatar_url: '' inbox_name: Webchat locale: en conversation_id: 338 created_at: '2026-09-21T00:46:20.542Z' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/error_message' '422': description: Validation failed content: application/json: schema: $ref: '#/components/schemas/error_validation' security: [] components: schemas: public_csat_update_payload: type: object required: - message properties: message: type: object required: - submitted_values properties: submitted_values: type: object description: The rating and optional comment. properties: csat_survey_response: type: object properties: rating: type: integer description: The score, 1 to 5. example: 4 feedback_message: type: string description: Optional free-text comment. description: The rating and optional comment the contact submitted. description: The answer to record. public_csat_message: type: object description: >- The survey message, and enough of the conversation and inbox around it for a hosted survey page to brand itself. properties: id: type: integer description: The survey message ID. content: type: string description: The question as it was asked. content_type: type: string description: Always `input_csat`. content_attributes: type: object description: >- Carries `submitted_values` once the contact has answered. Empty before that, which is how you tell an unanswered survey from an answered one. created_at: type: integer description: >- Unix epoch seconds. The fourteen-day edit window is measured from this. conversation_id: type: integer description: The conversation the survey belongs to. error_message: type: object description: >- The shape returned by `render_unauthorized`, `render_not_found_error` and `render_could_not_create_error`. properties: error: type: string description: A single human-readable message. example: Resource could not be found required: - error error_validation: type: object description: >- The shape returned by `render_record_invalid` when a model validation fails. properties: message: type: string description: The record's full error messages, comma-joined. example: Url has already been taken attributes: type: array description: The attributes that failed validation. items: type: string example: - url required: - message ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.