docs: Add clarification for ticket id parameter#372
Merged
anubhav-intercom merged 1 commit intomainfrom Feb 18, 2026
Merged
Conversation
anubhav-intercom
added
created-by-ai
documentation
Add info admonition to ticket endpoint parameter descriptions clarifying that the id parameter is the internal API id, not the ticket_id displayed in the Intercom Inbox. This mirrors the changes in developer-docs PR #720. Affected versions: 2.9, 2.10, 2.12, 2.13, 2.14, 2.15, and Unstable (0). Endpoints modified: GET, PUT, Reply (all versions), DELETE (2.15, Unstable). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
anubhav-intercom
force-pushed
the
anubhavbohidar/clarify-ticket-id-parameter
branch
from
890fabb to
1543191
Compare
VarshSuresh
approved these changes
Feb 18, 2026
anubhav-intercom
deleted the
anubhavbohidar/clarify-ticket-id-parameter
branch
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?
Users are confused when making API calls to ticket endpoints because they use the
ticket_iddisplayed in the Intercom Inbox (e.g., #75388508) instead of the internalidfrom the API response. developer-docs PR #720 already added clarifying admonitions to the developer-docs repo, but since Intercom-OpenAPI is not auto-synced, the same clarifications are needed here.How?
Added info admonitions to the
id/ticket_idpath parameter descriptions on all ticket endpoints (GET, PUT, DELETE, Reply) across versions 2.9, 2.10, 2.12, 2.13, 2.14, 2.15, and Unstable (0). Version 2.11 was skipped for consistency with developer-docs PR #720.Generated with Claude Code