Add API version 2.15 with conversation_rating behavior documentation#358
Open
markdennis22 wants to merge 2 commits intomainfrom
Open
Add API version 2.15 with conversation_rating behavior documentation#358markdennis22 wants to merge 2 commits intomainfrom
markdennis22 wants to merge 2 commits intomainfrom
Conversation
Adds the API spec for version 2.15 and documents the behavior change where conversation_rating now returns the latest completed rating (one with an actual value) instead of just the latest by ID. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Apply the same versioning documentation to the Unstable API spec. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
VarshSuresh
reviewed
Feb 5, 2026
| description: |- | ||
| The Conversation Rating object which contains information on the rating and/or remark added by a Contact and the Admin assigned to the conversation. | ||
|
|
||
| Note: Starting from version 2.15, this returns the latest completed conversation rating (one with an actual rating value). If no completed ratings exist, it falls back to the latest rating. In earlier versions, this returns the latest rating by ID regardless of completion status. |
Contributor
There was a problem hiding this comment.
Curious about this note here. Why do you think we need this here?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why?
Intercom API PR #456366 changed the behavior of
conversation_ratingin version 2.15. Previously, it returned the latest rating by ID regardless of completion status. Now it returns the latest completed rating (one with an actual value), falling back to latest rating if none exist. This behavior change needs to be documented in the OpenAPI spec so API consumers understand the version-specific behavior.How?
Adds the 2.15 API spec with an updated
conversation_ratingschema description that explains the version-specific behavior difference.Generated with Claude Code