Skip to content

Graduate list handling events endpoint to stable 2.15#560

Merged
faizzed merged 2 commits into
mainfrom
faiz/graduate-handling-events-2.15
Jun 22, 2026
Merged

Graduate list handling events endpoint to stable 2.15#560
faizzed merged 2 commits into
mainfrom
faiz/graduate-handling-events-2.15

Conversation

@faizzed

@faizzed faizzed commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

What

Graduates the Conversations → list handling events endpoint (GET /conversations/{id}/handling_events, listHandlingEvents) from Preview to stable 2.15 in the source-of-truth spec.

Adds to descriptions/2.15/api.intercom.io.yaml:

  • the endpoint path
  • the handling_event and handling_event_list response schemas
  • the teammate_reference schema (dependency of the response — previously only in descriptions/0/)

Endpoint is kept in descriptions/0/ (Unstable) too — it remains served on Intercom-Version: Preview, so existing Preview integrations are unaffected.

Additions-only (124 insertions, 0 deletions); spec parses as valid YAML; all $refs resolve within the 2.15 spec (error and intercom_version already present).

Postman collections regenerate automatically on merge to main (generate_postman_collection.yml). SDKs are unaffected (Fern stable source is 2.14; the endpoint is already in the unstable descriptions/0/ SDK source).

Why

Per #team-integration-capabilities thread, the API team confirmed the endpoint can go straight into the current stable version (2.15). Requesting customer: Preply.

Companion PRs (three-repo set)

  1. intercom/intercom#526927 — monolith: moves AddHandlingEventsApi into the 2.15 version block
  2. this PR — Intercom-OpenAPI source spec (feeds SDKs + Postman)
  3. intercom/developer-docs#987 — published reference + changelog

Land this PR first/alongside #987 so the published docs aren't hand-edited ahead of their source.

@faizzed faizzed force-pushed the faiz/graduate-handling-events-2.15 branch from dac01d8 to daf3b5f Compare June 22, 2026 14:55

@junaid-zaidi-intercom junaid-zaidi-intercom left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@faizzed faizzed merged commit 826e92d into main Jun 22, 2026
3 checks passed
@faizzed faizzed deleted the faiz/graduate-handling-events-2.15 branch June 22, 2026 15:16
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.

3 participants