Skip to content

Align the 2.17 companies endpoints with what the API does - #758

Open
markdennis22 wants to merge 3 commits into
mainfrom
markdennis/2-17-companies
Open

markdennis22 wants to merge 3 commits into
mainfrom
markdennis/2-17-companies

Conversation

@markdennis22

Copy link
Copy Markdown
Contributor

Why?

The 2.17 spec for the companies endpoints didn't match the API. company.notes had a shape the API never sends, the lists described cursor paging where the API pages by number, and most error responses were missing. Only the 2.17 spec changes, and the SDKs aren't generated from 2.17, so they are unaffected.

How?

Corrects the companies endpoints and company schemas to match the API's current behaviour, and adds the OAuth scopes each endpoint accepts to its description.

Generated with Claude Code

markdennis22 and others added 3 commits October 22, 2026 09:50
Gives company.notes the list shape the API sends, switches the page-number lists to pages_link, splits out the search response, documents the 400s and 503s the API returns, and adds the accepted OAuth scopes to most operations.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The create and update company requests reject an array value with a 400, reference attributes included, which is what the scalar-only schema already says.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
With `type` set to `user` or `users`, both retrieve-company operations return a paged `user.list` of the company's users instead of the company, so each 200 now lists that shape too.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

This branch has not been deployed

No deployments
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.

1 participant