...
Itential Platform Pricing Explore flexible plans and options for your team
Itential logo

Docker Hub

OpenAPI spec for Docker Hub container image registry automation via API

Docker Hub is Docker's cloud-based container registry service for storing, distributing, and managing container images, repositories, and organizations.

This project provides OpenAPI specs for automating against the Docker Hub REST API via an Integration Model. The -latest spec is a curated subset covering common CRUD for automation — see OpenAPIs below.

Table of Contents

Contents

Asset Description
OpenAPIs/ Docker Hub REST API OpenAPI specs — curated -latest plus full dated version
Studio Projects/Docker Hub 13 workflows covering common CRUD automation

Requirements

Requirement Version
Itential Platform 6.x
Docker Hub API v2 (see OpenAPIs below for exact spec version available)
Docker Hub Integration Model Required to build automation against the OpenAPI specs

Integration Configuration

Import the OpenAPI spec from OpenAPIs/ as an Integration Model in Admin > Integrations, then create an integration pointing at https://hub.docker.com.

Authentication is a Bearer JWT in the Authorization header:

Authorization: Bearer <token>

Obtain a token via POST /v2/users/login with your Docker Hub username and password.

The instance's authentication/server properties should look like this once configured:

{
  "authentication": {
    "bearerAuth": "<your-bearer-token>"
  },
  "server": {
    "protocol": "https",
    "host": "hub.docker.com",
    "base_path": ""
  }
}

OpenAPIs

Spec Version Operations Description
docker_hub-latest.json latest (curated) 16 Trimmed to 16 of 28 upstream operations covering common CRUD for automation — see breakdown below
docker_hub-beta.json beta 28 Full spec for Docker Hub API (beta).

docker_hub-latest.json

Actively-maintained spec (x-vendor-api-version: beta). Trimmed to 16 of 28 upstream operations covering common CRUD for automation.

Resources included, by category:

  • Access Tokens: List, create, retrieve, update, and delete personal access tokens
  • Repositories, Images & Tags: List repository images, image summaries, image tags by digest, repository tags, and individual tag details
  • Namespaces: Bulk delete images within a namespace/repository
  • Organization Settings: Retrieve and update organization settings
  • Authentication: User login to obtain a bearer token

docker_hub-beta.json

Full, unmodified vendor spec for Docker Hub API (beta) (28 operations) — the vendor's complete API surface, preserved as-is. See docker_hub-latest.json above for the curated subset if you just need common CRUD automation.


Studio Projects

Docker Hub Project

Backed by the Docker Hub:latest Integration Model (see docker_hub-latest.json above). The project contains 13 workflows organized into 4 folders, one atomic workflow per API operation, covering the common-CRUD subset of the curated spec.

Folder Structure

Folder Workflows Scope
Access Tokens List, Create, Get, Update, Delete Access Token Personal access token lifecycle
Repositories List Repository Tags, Get Repository Tag Repository tag lookup
Images List Repository Images, Get Repository Images Summary, List Image Tags By Digest, Delete Images Image inspection and bulk deletion
Organization Settings Get, Update Organization Settings Org-level configuration

Dependencies

Dependency Notes
Docker Hub:latest Integration Model Import from docker_hub-latest.json before importing the project
Docker Hub integration instance Create in Admin > Integrations with the connection properties above. Workflows are wired to an integration instance named Docker Hub — update the adapter_id value in each workflow task if yours is named differently

Agentic Infrastructure Operations Start Here

See how Itential connects AI reasoning to governed execution across your entire infrastructure.