diff --git a/api/registry.npmjs.com/stage.yaml b/api/registry.npmjs.com/stage.yaml index fd5a3f0..a92706a 100644 --- a/api/registry.npmjs.com/stage.yaml +++ b/api/registry.npmjs.com/stage.yaml @@ -101,12 +101,17 @@ paths: description: | Submit a package version to staging for maintainer review. + This endpoint supports both staging a new version of an existing package and + creating a brand-new package. When the package does not yet exist in the + registry, staging its first version creates the package with a standardized placeholder version. + The authenticated publisher must be allowed to create the package name (for example, hold the + relevant scope or organization permissions). + The request body must contain a publish-style packument payload, including version metadata and package attachments. The staged item can then be reviewed, inspected, approved, or deleted by authorized maintainers. ## Requirements - - Package MUST exist or be creatable by the authenticated publisher - User MUST be authenticated with a valid npm token - Request body MUST include required fields in `StagedPackumentRequest` operationId: stagePackageVersion @@ -323,7 +328,7 @@ paths: This endpoint moves a version from staged review state to a published package version. On success, the staged record will be processed and the package version will become - installable. + installable. ## Requirements - `stage-id` MUST reference an existing staged package version @@ -799,4 +804,4 @@ components: internal_error: summary: "Internal Server Error" value: - message: "An error occurred while processing your request." \ No newline at end of file + message: "An error occurred while processing your request."