POST

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

http://codeartifact.{region}.amazonaws.com/v1/package/versions/delete#domain&repository&format&package

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

Access Token Required: API Key

Query Params

domainstringrequired

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.

repositorystringrequired

The name of the repository that contains the package versions to delete.

formatstringrequired

The format of the package versions to delete.

Allowed:

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>

packagestringrequired

The name of the package with the versions to delete.

Body Params

versionsarrayrequired

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

expectedStatusstring

The expected status of the package version to delete.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://codeartifact.{region}.amazonaws.com/v1/package/versions/delete#domain&repository&format&package' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}