Docker Hub

24 tools available

Docker Hub is a service provided by Docker for finding and sharing container images with your team.

Connect Docker Hub to Definable to triage issues, review pull requests, monitor builds. Personas call Docker Hub's 24 tools directly from chat or scheduled flows. Wire it into a triage, review, or release-management persona — every action runs scoped, reviewable, and logged.

Common workflows with Docker Hub

Triage incoming issues

Webhook fires on every new issue
Persona summarises and labels it
Assigns the right engineer

Auto-review PRs

Pull the diff
Run a code-review persona
Post structured feedback as PR comment

Failing-build alerts

CI sends a failure event
Agent inspects logs and stack trace
Drops a debug summary in Slack

Release notes from commits

Read commits since last tag
Group by type with the model
Post to a changelog channel

Docker Hub actions 24

Every Docker Hub action below is a callable tool any Definable persona can invoke.

Add Organization Member

Invite a user to join a Docker Hub organization. Sends an invitation email to the specified user (by Docker ID or email). The user must accept the invitation to become a member. Requires owner or admin privileges on the target organization.

Create Docker Hub Organization

Create a new Docker Hub organization. Note: This endpoint requires JWT authentication obtained via /v2/users/login and may have restricted access.

Create Docker Hub Repository

Creates a new Docker Hub repository under the specified namespace. Use this to programmatically create public or private repositories for storing Docker images. Requires proper authentication with write permissions to the namespace.

Create Docker Hub Webhook

Create a webhook on a Docker Hub repository to receive notifications on image push events. This is a two-step process: 1. Create the webhook with a name 2. Add a hook URL to the webhook Requires admin permissions on the repository.

Delete Repository Images

Delete one or more images from your Docker Hub namespace using the bulk delete API. IMPORTANT REQUIREMENTS: - You must own the namespace (your username or an organization you admin) - You cannot delete images from 'library' (official Docker images) - Images are identified by SHA256 digest (get from LIST_IMAGES action) USAGE: 1. First use LIST_IMAGES to get image digests for your repository 2. Then call this action with the namespace, repository, and digest(s) Example: DELETE_IMAGE( namespace="myusername", manifests=[{"repository": "myapp", "digest": "sha256:abc123..."}] ). WARNING: Deletion is permanent and irreversible — obtain explicit user confirmation before calling this action.

Delete Docker Hub Organization

Permanently deletes a Docker Hub organization. Requires owner permissions on the organization. This action is idempotent - deleting a non-existent organization returns success (404 treated as success). WARNING: Deletion is irreversible and removes all associated repositories, teams, and members.

Delete Docker Hub Repository

Permanently deletes a Docker Hub repository and all its images/tags. WARNING: This action is irreversible. All images, tags, and metadata will be permanently removed. This operation is idempotent - deleting a non-existent repository returns success. You must have admin/owner permissions on the repository to delete it.

Delete Repository Tag

Permanently delete a specific tag from a Docker Hub repository. Requirements: - Must have write/admin access to the repository - The namespace must be your username or an organization you belong to - This action is irreversible - the tag will be permanently removed Note: Cannot delete tags from official Docker Hub images (library namespace).

Delete Docker Hub Team

Permanently deletes a team from a Docker Hub organization. This operation is idempotent - deleting a non-existent team will succeed silently. Requires organization admin permissions. Use DOCKER_HUB_LIST_TEAMS to find available teams before deletion.

Delete Docker Hub repository webhook

Deletes a specific webhook from a Docker Hub repository. Use this tool to remove webhook configurations from repositories you own or have admin access to. This is useful for cleaning up outdated, misconfigured, or no longer needed webhooks. Prerequisites: - You must have admin access to the repository - The repository and webhook must exist - Use the list webhooks action first to get the webhook ID Returns a success message if the webhook was deleted, or an error if the webhook doesn't exist or you lack permission to delete it.

Get Docker Hub Image

Retrieve details about a specific platform-specific image variant by its digest. This tool searches through repository tags to find and return metadata for an image matching the specified SHA256 digest. Returns architecture, OS, size, status, and timestamps. Use LIST_IMAGES first to discover available digests, then use this tool to get details about a specific image variant. Example: GET_IMAGE(namespace="library", repository="ubuntu", digest="sha256:a4453623f2f8319cfff65c43da9be80fe83b1a7ce689579b475867d69495b782")

Get Docker Hub Repository

Retrieves detailed information about a specific Docker Hub repository. Use this to get repository metadata including description, star/pull counts, permissions, and configuration. Works with both public and private repositories (authentication required for private repos).

Get Docker Hub Tag

Tool to retrieve details of a specific Docker Hub repository tag. Use after confirming the namespace, repository, and tag name.

Get Docker Hub Team

Retrieve details of a specific team (group) within a Docker Hub organization. Returns the team's ID, name, and description. Requires organization membership with appropriate permissions to view team details.

Get Docker Hub Webhook

Retrieves details of a specific Docker Hub webhook by its ID. Use this tool when you need to inspect an existing webhook's configuration, including its target URL, configured events, and active status. You must have admin or write access to the repository to retrieve webhook details. Prerequisites: - You must have admin or write access to the repository - The webhook ID must exist (can be obtained from the list webhooks action) Returns the webhook's ID, name, target URL, events, active status, and timestamps.

List Organization Access Tokens

Tool to list all organization access tokens for a Docker Hub organization. Use when you need to view or audit access tokens associated with an organization. Requires appropriate organization permissions to view tokens.

List Docker Hub Organizations

List Docker Hub organizations that the authenticated user belongs to. Returns a paginated list of organizations with details like name, company, and badge status; some metadata fields may be absent — use org name for follow-up detail calls when complete metadata is required. An empty result is valid and indicates the user belongs to no organizations. Use this to discover which organizations a user has access to before performing org-specific operations.

List Docker Hub Organization Members

Lists members of a Docker Hub organization with their roles and details. Use this tool to: - Audit organization membership - View member roles (owner, member) - Check team assignments for members - Export organization member lists Requirements: - You must have access to the organization (owner or member role) - Authentication via Personal Access Token (PAT) which is exchanged for JWT Note: This endpoint requires organization-level access and proper authentication.

List Docker Hub Repositories

Tool to list repositories under a namespace. Use when you need to enumerate repositories within a specific Docker Hub namespace, with optional filtering and pagination.

List Team Members

List members of a Docker Hub team (group) within an organization. Returns a paginated list of team members with their user details. Requires organization membership with appropriate permissions to view team members.

List Organization Teams

List all teams (groups) within a Docker Hub organization. Requires organization membership with appropriate permissions. Teams in Docker Hub are called 'groups' in the API.

List Docker Hub repository webhooks

Lists all webhooks configured for a Docker Hub repository. Use this tool to retrieve webhook configurations for repositories you own or have admin access to. Webhooks are triggered when specific events occur in the repository (e.g., image push). Prerequisites: - You must have admin or write access to the repository - The repository must exist under the specified namespace Returns a paginated list of webhooks with their IDs, names, target URLs, configured events, and status.

Remove Organization Member

Remove a member from a Docker Hub organization. This action revokes the user's access to the organization and all its repositories. Requires organization admin privileges. The operation is idempotent - removing a non-member will not cause an error.

Remove Team Member

Remove a user from a Docker Hub organization team (group). Use this action to revoke a user's membership from a specific team. The operation is idempotent - removing a user who is not a member will succeed silently.

Frequently asked questions

What can I automate with Docker Hub on Definable?

Anything Docker Hub exposes through its API. Common developer tools workflows on Definable include triage issues, review pull requests, monitor builds. Personas can call any of the 24 Docker Hub tools directly, then chain the result into another integration without you writing code.

How does Docker Hub authentication work?

Docker Hub uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Docker Hub integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 24 Docker Hub tools. You only need a separate Docker Hub subscription if Docker Hub itself charges per seat or per API call.

Is using Docker Hub through Definable secure?

Every call from a persona to Docker Hub is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Docker Hub on Definable?

Sign up for Definable, open the integrations page, find Docker Hub, and connect via OAuth or API key. You can immediately attach Docker Hub to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Docker Hub actions does Definable expose?

Definable exposes all 24 Docker Hub actions as callable tools — including `Add Organization Member`, `Create Docker Hub Organization`, `Create Docker Hub Repository`, plus 21 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Docker Hub?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations