Skip to content

[PEP-1898] Document ownerUserIds on company responses#1861

Merged
Rob-Codat merged 2 commits into
mainfrom
pep-1898-company-owners-docs
Jul 21, 2026
Merged

[PEP-1898] Document ownerUserIds on company responses#1861
Rob-Codat merged 2 commits into
mainfrom
pep-1898-company-owners-docs

Conversation

@Rob-Codat

@Rob-Codat Rob-Codat commented Jul 14, 2026

Copy link
Copy Markdown
Collaborator

PEP-1898 — document company owners on company responses

https://codatdocs.atlassian.net/browse/PEP-1898

The public API is adding a read-only ownerUserIds property to all company responses (codat-internal/public-api#131) — the IDs of the users assigned as owners of the company, empty when unassigned. This PR documents it:

  • New "View company owners" section in docs/using-the-api/managing-companies.md, covering the read-only property, the empty-array behavior, and that owners are managed in the Codat Portal (the create/update endpoints don't accept the property).

The API reference schema is updated separately in codat-internal/oas#66 and flows into static/oas/ here via the pipeline bot — no hand edits to the specs in this PR.

Merge timing

Hold until codat-internal/public-api#131 deploys so the docs don't describe a field that isn't returned yet. The Portal owner-assignment UI (PEP-1865 etc.) is still in progress, so the copy references owner management in the Portal without describing specific UI.

🤖 Generated with Claude Code

Company responses from the public API now include a read-only
ownerUserIds property (codat-internal/public-api#131). Adds a
changelog post and a section in the managing-companies guide.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
codat-docs Ready Ready Preview, Comment Jul 14, 2026 4:03pm

Request Review

Comment thread docs/using-the-api/managing-companies.md Outdated
Comment thread docs/using-the-api/managing-companies.md Outdated
Rewrites the company-owners section in active voice per the Vale
Google.Passive findings, and removes the changelog post (and its
authors.yml entry) from this PR.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Link check results for preview deployment (https://codat-docs-git-pep-1898-company-owners-docs-codat.vercel.app):

[]

@Rob-Codat
Rob-Codat marked this pull request as ready for review July 21, 2026 10:47
@Rob-Codat
Rob-Codat enabled auto-merge July 21, 2026 11:33
@Rob-Codat
Rob-Codat merged commit 4356862 into main Jul 21, 2026
7 of 8 checks passed
@Rob-Codat
Rob-Codat deleted the pep-1898-company-owners-docs branch July 21, 2026 12:44
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