Sync OpenAPI spec: 3641461 - #66
Conversation
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
|
Closed after a successful DOCS_PR_TOKEN write-path test. This PR intentionally generated a historical OpenAPI spec and must not be merged. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: e6f5e7ca54
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| "enum": [ | ||
| "github", | ||
| "gitlab", | ||
| "bitbucket" | ||
| ], |
There was a problem hiding this comment.
Restore Azure to the repository provider schema
For organizations with the documented Azure DevOps integration, /repos can return repositories whose provider is azure; the previous public schema explicitly included that value and its Azure-specific providerKey/baseUrl semantics. Narrowing this response enum causes generated clients and response validators to reject legitimate Azure repository payloads, even though platform/repositories/azure-devops.mdx:62-86 still directs customers to connect and select those repositories. Restore azure and the accompanying Azure field descriptions.
Useful? React with 👍 / 👎.
Regenerated
openapi.jsonfrom the public REST spec that just shipped to prod.The API reference pages resolve their operations from this spec, so this keeps the published reference in sync with the live API.
Note
Low Risk
Documentation-only spec sync in this repo; the main reviewer note is that API clients reading the reference should no longer expect Azure in
/reposresponses.Overview
Regenerates
openapi.jsonso published API reference matches the live REST API (source commit3641461). Most of the diff is JSON formatting (multi-linetags,enum, andrequiredarrays); operation paths and request/response shapes are otherwise unchanged.The meaningful contract update is in
UnifiedRepoDto:azureis removed from theproviderenum, and field descriptions forname,providerKey, andbaseUrlno longer mention Azure DevOps—repos are documented as GitHub, GitLab, and Bitbucket only, withbaseUrlscoped to GitHub Enterprise.Reviewed by Cursor Bugbot for commit e6f5e7c. Bugbot is set up for automated code reviews on this repo. Configure here.