Post v1packageversionsdeletedomainandrepositoryandformatandpackage

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1438166195.6 KB

Deletes one or more versions of a package. A deleted package version cannot be restored in your repository. If you want to remove a package version from your repository and be able to restore it later, set its status to <code>Archived</code>. Archived packages cannot be downloaded from a repository and don't show up with list package APIs (for example, <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_ListPackageVersions.html">ListPackageVersions</a>), but you can restore them using <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_UpdatePackageVersionsStatus.html">UpdatePackageVersionsStatus</a>.

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

Query parameters

domainstring required

The name of the domain that contains the package to delete.

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 to delete.

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

The format of the package versions to delete.

namespacestring

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

packagestring required

The name of the package with the versions to delete.

Request body

versionsPackageVersion[] required

An array of strings that specify the versions of the package to delete.

The expected status of the package version to delete.

Response

Success

successfulVersionsobject

A list of the package versions that were successfully deleted. The status of every successful version will be <code>Deleted</code>.

failedVersionsobject

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