Skip to content

Move company notes API to Unstable and fix note schema #380

Open
efassor wants to merge 1 commit intomainfrom
diane.gordon/add-create-company-note-to-v2-15
Open

Move company notes API to Unstable and fix note schema #380
efassor wants to merge 1 commit intomainfrom
diane.gordon/add-create-company-note-to-v2-15

Conversation

@efassor
Copy link
Contributor

@efassor efassor commented Feb 24, 2026

Why?

Per API versioning policy, new features should ship to Unstable first. The AddCompanyNotesApi version change is being moved from 2.15 to Unstable in the monolith (intercom/intercom#486220), so the OpenAPI spec needs to match.

How?

Revert the POST endpoint addition from descriptions/2.15/, fix the Unstable spec (descriptions/0/) with the correct company_id path parameter name, add the company property to the note schema, and update the schema description to cover both contacts and companies.

Related:

  • intercom/intercom#486220
  • intercom/developer-docs#735

Generated with Claude Code

@VedranZoricic
Copy link
Contributor

@efassor The PR description confuses me here.
It says we merged this change to docs on 2.15 but the PR points to Unstable and I can't find it in the 2.15 file.
I assume there is some confusion here and it should go on Unstable as well?

@efassor efassor changed the title Add POST /companies/{company_id}/notes to v2.15 spec Move company notes API to Unstable and fix note schema Mar 19, 2026
@efassor efassor changed the title Move company notes API to Unstable and fix note schema Move company notes API to Unstable and fix note schema Mar 19, 2026
@efassor
Copy link
Contributor Author

efassor commented Mar 19, 2026

@VedranZoricic I updated the description to reflect what is actually happening. Apologies for the branch name being confusing. I've stripped out everything but the updates to descriptions/0/api.intercom.io.yaml

…roperty to note schema

- Fix path parameter: {id} → {company_id} to match Rails route
- Add company property to note schema (mirrors contact property)
- Update note schema description to mention companies

Co-Authored-By: Claude Opus 4.6 <[email protected]>
@efassor efassor force-pushed the diane.gordon/add-create-company-note-to-v2-15 branch from 9c37a5e to b30d38d Compare March 25, 2026 20:23
@efassor efassor closed this Mar 25, 2026
@efassor efassor deleted the diane.gordon/add-create-company-note-to-v2-15 branch March 25, 2026 21:15
@efassor efassor restored the diane.gordon/add-create-company-note-to-v2-15 branch March 25, 2026 21:18
@efassor efassor reopened this Mar 25, 2026
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