How to Delete an Artifact from Vultr Container Registry Repository

Updated on March 20, 2025

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}"
    

Comments

No comments yet.