An artifact refers to a specific version of a container image stored within a repository in the Vultr Container Registry. It represents the packaged and deployable unit of the image, containing metadata such as its digest, tags, and associated push/pull times. By retrieving this data, you can gain insights into the artifact’s version, usage patterns, and storage, helping you manage and optimize your container images more effectively.

Follow this guide to retrieve artifact details 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 GET request to the Read Artifact endpoint to retrieve the target artifact’s details.
   console

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