Skip to content

Document channel.{initial,current} on Conversations API (Preview)#505

Merged
hrp merged 2 commits into
mainfrom
hitenparmar/channel-conversation-api
May 20, 2026
Merged

Document channel.{initial,current} on Conversations API (Preview)#505
hrp merged 2 commits into
mainfrom
hitenparmar/channel-conversation-api

Conversation

@hrp
Copy link
Copy Markdown
Contributor

@hrp hrp commented May 19, 2026

Why?

The Conversations API response now includes a channel object that exposes both the channel through which a conversation was originally started (initial) and its current channel (current). This documents that addition in the OpenAPI specification for the Preview API version.

How?

Adds a new conversation_channel schema and the channel field to both conversation and conversation_list_item response schemas. Updates all 15 inline response examples to include example channel values.

Generated with Claude Code

Adds the `conversation_channel` schema and the `channel` field to both
`conversation` and `conversation_list_item` response objects. The field
is Preview-only, matching the `AddChannelToConversation` versioning
change shipped in intercom/intercom#505795.

Updates all 15 inline response examples (list, show, update, reply,
assign, redact, attach/detach endpoints) to include
`channel: { initial, current }` values.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@hrp hrp self-assigned this May 19, 2026
@hrp hrp requested review from a team, kstenson and marcmlc May 19, 2026 18:05
Comment thread descriptions/0/api.intercom.io.yaml Outdated
Comment thread descriptions/0/api.intercom.io.yaml Outdated
Comment thread descriptions/0/api.intercom.io.yaml Outdated
@hrp hrp enabled auto-merge (squash) May 20, 2026 16:02
@hrp hrp merged commit 848bcf2 into main May 20, 2026
2 checks passed
@hrp hrp deleted the hitenparmar/channel-conversation-api branch May 20, 2026 16:04
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.

2 participants