Skip to content

Update from code changes: document assistant feedback field - #7400

Merged
ethanpalm merged 2 commits into
mainfrom
mintlify/0a28d486
Sep 24, 2026
Merged

ethanpalm merged 2 commits into
mainfrom
mintlify/0a28d486

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 17, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Assistant analytics exports now include a feedback field that records the user's thumbs rating on each assistant response. The CSV export adds a trailing feedback column with positive, negative, or empty, and the GET /v1/analytics/{projectId}/assistant conversations response adds the same field as "positive", "negative", or null. When a user regenerates an answer and rates it again, the latest rating is used. Triggered by https://github.com/mintlify/server/pull/8250.

Changes

  • analytics/export.mdx: Added feedback column to the assistant exports section.
  • api/analytics/assistant-conversations.mdx: Added feedback field to the conversation data list.
  • analytics.openapi.json: Added feedback property to AssistantConversationsResponse.
  • Mirrored all updates in the es, fr, and zh translations.

Note

Low Risk
Documentation-only updates to OpenAPI and MDX; no runtime or API implementation changes in this repo.

Overview
Documents a new feedback field on assistant analytics so it matches the product/API change from the server.

OpenAPI (analytics.openapi.json and es/fr/zh copies): each conversation row in AssistantConversationsResponse now includes required feedback (positive, negative, or null) for the user’s thumbs rating on that turn’s response.

User docs: analytics/export.mdx reframes the assistant CSV section as a column table and adds feedback alongside resolutionStatus, plus a sample prompt to analyze sources cited in negative responses. api/analytics/assistant-conversations.mdx lists feedback in the per-row field reference.

All of the above is mirrored in Spanish, French, and Chinese.

Reviewed by Cursor Bugbot for commit 0ca9a7f. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Sep 17, 2026 •

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
mintlify 🟢 Ready View Preview Sep 24, 2026, 11:47 PM

Regenerating an assistant response soft-deletes the prior response and
its rating, so the "latest rating is used" sentence implied ratings carry
over when they don't. Remove it from the export page, API page, and
OpenAPI spec in all locales.

Format the assistant export columns as a table to match the traffic
export section, and add a feedback-based analysis prompt.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@ethanpalm
ethanpalm merged commit abb0d24 into main Sep 24, 2026
4 of 5 checks passed
@ethanpalm
ethanpalm deleted the mintlify/0a28d486 branch September 24, 2026 23:47

This branch was successfully deployed

1 active deployment
staging — 0ca9a7f6 Deployed Sep 24, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant