Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1438166195.6 KB

Deletes the assets in package versions and sets the package versions' status to Disposed. A disposed package version cannot be restored in your repository because its assets are deleted.

To view all disposed package versions in a repository, use ListPackageVersions and set the status parameter to Disposed.

To view information about a disposed package version, use DescribePackageVersion.

post/v1/package/versions/dispose#domain&repository&format&package

Query parameters

domainstring required

The name of the domain that contains the repository you want to dispose.

domain-ownerstring

The 12-digit account number of the Amazon Web Services account that owns the domain. It does not include dashes or spaces.

repositorystring required

The name of the repository that contains the package versions you want to dispose.

format'npm' | 'pypi' | 'maven' | 'nuget' | 'generic' required

A format that specifies the type of package versions you want to dispose.

namespacestring
<p>The namespace of the package versions to be disposed. The package version component that specifies its namespace depends on its type. For example:</p> <ul> <li> <p> The namespace of a Maven package version is its <code>groupId</code>. </p> </li> <li> <p> The namespace of an npm package version is its <code>scope</code>. </p> </li> <li> <p> Python and NuGet package versions do not contain a corresponding component, package versions of those formats do not have a namespace. </p> </li> <li> <p> The namespace of a generic package is its <code>namespace</code>. </p> </li> </ul>
packagestring required

The name of the package with the versions you want to dispose.

Request body

versionsPackageVersion[] required

The versions of the package you want to dispose.

versionRevisionsobject

The revisions of the package versions you want to dispose.

expectedStatus'Published' | 'Unfinished' | 'Unlisted' | 'Archived' | 'Disposed' | 'Deleted'

The expected status of the package version to dispose.

Response

Success

successfulVersionsobject

A list of the package versions that were successfully disposed.

failedVersionsobject
<p> A <code>PackageVersionError</code> object that contains a map of errors codes for the disposed package versions that failed. The possible error codes are: </p> <ul> <li> <p> <code>ALREADY_EXISTS</code> </p> </li> <li> <p> <code>MISMATCHED_REVISION</code> </p> </li> <li> <p> <code>MISMATCHED_STATUS</code> </p> </li> <li> <p> <code>NOT_ALLOWED</code> </p> </li> <li> <p> <code>NOT_FOUND</code> </p> </li> <li> <p> <code>SKIPPED</code> </p> </li> </ul>