Vultr DocsLatest Content


How to Delete an Artifact from Vultr Container Registry Repository

Updated on 11 September, 2025

Permanently removes the selected resource from your Vultr account.


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.