Deleting an artifact from the Vultr Container Registry permanently removes a specific version of a container image from a repository. This action helps eliminate obsolete versions, ensuring that only relevant, up-to-date container images remain in the repository.

Follow this guide to delete an artifact from the container registry repository on your Vultr account using the Vultr API.

1. Send a GET request to the List Container Registries endpoint and note the target registry’s ID.
   console

   $ curl "https://api.vultr.com/v2/registries" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"

2. Send a GET request to the List Repositories endpoint to list all the available repositories and note the target repository image.
   console

   $ curl "https://api.vultr.com/v2/registry/{registry-id}/repositories" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"

3. Send a GET request to the List Artifacts endpoint to list all the available artifacts and note the target artifact’s digest.
   console

   $ curl "https://api.vultr.com/v2/registry/{registry-id}/repository/{repository-image}/artifacts" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"
   

4. Send a DELETE request to the Delete Artifact endpoint to delete the target artifact.
   console

   $ curl "https://api.vultr.com/v2/registry/{registry-id}/repository/{repository-image}/artifact/{artifact-digest}" \
       -X DELETE \
       -H "Authorization: Bearer ${VULTR_API_KEY}"