docs(tickets): document linked_conversations link/unlink endpoints (Preview)#566
Merged
Conversation
…review)
Adds POST /tickets/{ticket_id}/linked_conversations and
DELETE /tickets/{ticket_id}/linked_conversations/{id} to the Preview spec.
These endpoints are available on the Preview version of the API but were
missing from the spec, so they were undocumented.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The linked_objects response example used lowercase `category: tracker`; the linked_object schema enum value is `Tracker`. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…imit Add the required `write_tickets` OAuth scope to both linked_conversations endpoint descriptions, and note the 2,500 linked-conversation limit on the link endpoint. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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?
The
POST /tickets/{ticket_id}/linked_conversationsandDELETE /tickets/{ticket_id}/linked_conversations/{id}endpoints (link / unlink a conversation to a tracker ticket after it has been created) are available on the Preview version of the API, but were never added to the Preview spec. They're undocumented even though other Preview-only endpoints are documented here. This adds them so they're discoverable in the API reference.How?
Adds the two endpoints to
descriptions/0/api.intercom.io.yaml, reusing the existingconversation,error, andintercom_versionschemas and following the style of the sibling nested ticket endpoints (/tickets/{ticket_id}/tags). No new schemas or tags. Preview only — these are not on a stable version yet, so2.14/2.15are unchanged.fern checkreports no new errors or warnings versusmain(the pre-existing errors are in unrelated areas of the spec).Follow-ups (not in this PR)
Generated with Claude Code