Skip to content

feat(eng-10907): updates api docs to populate generic upstreams#325

Merged
apoclyps merged 1 commit into
mainfrom
kyleharrison/eng-10907/update-api-docs-for-generic
Feb 6, 2026
Merged

feat(eng-10907): updates api docs to populate generic upstreams#325
apoclyps merged 1 commit into
mainfrom
kyleharrison/eng-10907/update-api-docs-for-generic

Conversation

@apoclyps
Copy link
Copy Markdown
Contributor

@apoclyps apoclyps commented Feb 6, 2026

What’s Changed

The API documentation stored in the repository has been updated to the latest version to contain the API changes for the Generic format + upstreams.

relates to:

Additional Notes

During review, it was discovered that the new Generic upstreams documentation was missing from
https://help.cloudsmith.io/reference/repos_upstream_generic_create

Screenshot 2026-02-06 at 09 03 54

This was previously missing because the npm run schema command had not been executed, which is required to regenerate and update the API documentation and for those changes to be committed to the repository.

As a future follow up, we should verify if the API documentation differs are part of CI to catch issues like this before we release changes.

@apoclyps apoclyps self-assigned this Feb 6, 2026
Copilot AI review requested due to automatic review settings February 6, 2026 09:09
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 6, 2026

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

Project Deployment Actions Updated (UTC)
cloudsmith-docs Ready Ready Preview, Comment Feb 6, 2026 9:19am

Request Review

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the API documentation schemas to the latest version (1.985.3), addressing the previously missing Generic upstreams documentation. The changes are auto-generated from running npm run schemas:download and include several enhancements:

Changes:

  • Added Generic format package upload and validation endpoints
  • Added Generic upstream configuration support with required upstream_prefix field
  • Added bulk package operations endpoint for multi-package actions
  • Various schema refinements including field nullability updates and new properties

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 1 comment.

File Description
src/content/schemas/api-schema-v2.json Version bump from 1.966.0 to 1.985.3
src/content/schemas/api-schema-v1.json Major schema updates including new Generic package endpoints, Generic upstream configs, bulk action endpoints, and various schema enhancements
README.md Updated documentation command from npm run schema to npm run schema:download

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
@apoclyps apoclyps force-pushed the kyleharrison/eng-10907/update-api-docs-for-generic branch from 5d369a8 to b7ef3c5 Compare February 6, 2026 09:16
@apoclyps apoclyps merged commit 151323b into main Feb 6, 2026
2 checks passed
@apoclyps apoclyps deleted the kyleharrison/eng-10907/update-api-docs-for-generic branch February 6, 2026 09:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

3 participants