> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Docker Hub

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

![Docker Hub logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/docker_hub.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=e5790d52a64272535a5811e05e54e378)

* **Category:** developer tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 24
* **Triggers:** 0
* **Slug:** `DOCKER_HUB`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Organization Member
>
> **Slug:** `DOCKER_HUB_ADD_ORG_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.
>
> #### Input Parameters
>
> **org** `string` *required*
>
> Name of the Docker Hub organization to invite a user to. Must be an organization you have owner/admin access to.
>
> **role** `string ("member" | "editor" | "owner")`
>
> Role to assign to the invited member. Valid values: 'member' (read access), 'editor' (read/write access), 'owner' (full admin access).
>
> **team** `string`
>
> Optional team name within the organization to add the member to.
>
> **invitee** `string` *required*
>
> Docker ID (username) or email address of the user to invite to the organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Docker Hub Organization
>
> **Slug:** `DOCKER_HUB_CREATE_ORGANIZATION`
>
> Create a new Docker Hub organization. Note: This endpoint requires JWT authentication obtained via /v2/users/login and may have restricted access.
>
> #### Input Parameters
>
> **company** `string`
>
> Company name associated with the organization
>
> **orgname** `string` *required*
>
> Unique slug for the organization. Must be lowercase letters, numbers, '.', '\_' or '-' only; at least 2 characters long.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Docker Hub Repository
>
> **Slug:** `DOCKER_HUB_CREATE_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.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The repository name (must be lowercase; can contain letters, numbers, '.', '\_', or '-')
>
> **namespace** `string` *required*
>
> The Docker Hub username or organization name under which to create the repository Must match the authenticated Docker Hub account identity; mismatches cause authorization failures.
>
> **is\_private** `boolean`
>
> If true, creates a private repository (requires paid plan). Defaults to false (public).
>
> **description** `string`
>
> Short description of the repository (max 100 characters)
>
> **full\_description** `string`
>
> Full description or README content for the repository (supports Markdown)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Docker Hub Webhook
>
> **Slug:** `DOCKER_HUB_CREATE_WEBHOOK`
>
> Create a webhook on a Docker Hub repository for image push notifications, then add its hook URL; repository admin permissions are required. If the second step fails, the webhook may already have been created without the hook URL.
>
> #### Input Parameters
>
> **hook\_url** `string` *required*
>
> The URL that will receive HTTP POST requests when the webhook is triggered (must be publicly accessible) Must use HTTPS. Failed deliveries are silent — no error is returned if the endpoint is unreachable.
>
> **namespace** `string` *required*
>
> The Docker Hub namespace (your username or organization name) where the repository exists Must be lowercase letters, numbers, and hyphens only.
>
> **repository** `string` *required*
>
> The name of the repository to add the webhook to. Must be a repository you have admin access to Must be lowercase letters, numbers, and hyphens only.
>
> **webhook\_name** `string` *required*
>
> A descriptive name for the webhook (e.g., 'CI trigger', 'deploy-notification')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Repository Images
>
> **Slug:** `DOCKER_HUB_DELETE_IMAGE`
>
> Delete up to 100 image manifests from a Docker Hub namespace by repository and SHA256 digest, or use a dry run to validate the request without deleting. Namespace write access is required. The reported deletion count may be based on the number submitted rather than confirmed deletions.
>
> #### Input Parameters
>
> **dry\_run** `boolean`
>
> If true, validates the request without actually deleting images. Useful for testing what would be deleted
>
> **manifests** `array` *required*
>
> List of image manifests to delete. Each manifest specifies a repository name and SHA256 digest. Maximum 100 manifests per request
>
> **namespace** `string` *required*
>
> Your Docker Hub username or organization name. Must be a namespace you have write access to. Note: You cannot delete images from 'library' (official images)
>
> **ignore\_warnings** `array`
>
> List of warning types to ignore. Options: 'is\_active' (ignore active image warnings), 'current\_tag' (ignore current tag warnings)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Docker Hub Organization
>
> **Slug:** `DOCKER_HUB_DELETE_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.
>
> #### Input Parameters
>
> **organization** `string` *required*
>
> The unique slug/name of the organization to delete. Must be an organization you have owner permissions on. Supports lowercase letters, numbers, underscores, hyphens, and dots.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Docker Hub Repository
>
> **Slug:** `DOCKER_HUB_DELETE_REPOSITORY`
>
> Permanently delete a Docker Hub repository and its images, tags, and metadata. This irreversible action requires repository admin or owner permissions; a 404 response is reported as an error.
>
> #### Input Parameters
>
> **namespace** `string` *required*
>
> The Docker Hub namespace (username or organization name) that owns the repository to delete
>
> **repository** `string` *required*
>
> The name of the repository to delete. Must be the repository name without the namespace prefix
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Repository Tag
>
> **Slug:** `DOCKER_HUB_DELETE_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).
>
> #### Input Parameters
>
> **tag** `string` *required*
>
> Tag name to delete from the repository
>
> **namespace** `string` *required*
>
> Docker Hub namespace (your username or organization name). Must have write access to the repository.
>
> **repository** `string` *required*
>
> Name of the repository containing the tag to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Docker Hub Team
>
> **Slug:** `DOCKER_HUB_DELETE_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.
>
> #### Input Parameters
>
> **org\_name** `string` *required*
>
> Slug/identifier of the Docker Hub organization owning the team (e.g., 'my-org')
>
> **team\_name** `string` *required*
>
> Slug/identifier of the team to delete (e.g., 'dev-team')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Docker Hub repository webhook
>
> **Slug:** `DOCKER_HUB_DELETE_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.
>
> #### Input Parameters
>
> **namespace** `string` *required*
>
> The Docker Hub namespace (username or organization name) that owns the repository. Must be a namespace you have admin access to.
>
> **repository** `string` *required*
>
> The name of the repository containing the webhook to delete. The repository must exist under the specified namespace.
>
> **webhook\_id** `integer` *required*
>
> The unique numeric identifier of the webhook to delete. You can obtain webhook IDs by using the list webhooks action first.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Docker Hub Image
>
> **Slug:** `DOCKER_HUB_GET_IMAGE`
>
> Retrieve a platform-specific image variant by digest by searching repository tags. The search is unauthenticated and scans at most 50 pages; a not-found result does not establish that the image is absent beyond that limit.
>
> #### Input Parameters
>
> **digest** `string` *required*
>
> Content digest (SHA256) of the image to retrieve. Must start with 'sha256:' followed by 64 hexadecimal characters. Use LIST\_IMAGES to discover available digests for a repository. Distinct from the numeric image\_id used by DOCKER\_HUB\_DELETE\_IMAGE — these formats are not interchangeable.
>
> **namespace** `string` *required*
>
> User or organization namespace that owns the repository. Use 'library' for official Docker images (e.g., ubuntu, alpine, nginx)
>
> **repository** `string` *required*
>
> Name of the repository within the namespace
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Docker Hub Repository
>
> **Slug:** `DOCKER_HUB_GET_REPOSITORY`
>
> Retrieve detailed metadata for a Docker Hub repository, including available description, counts, permissions, and configuration. The request is unauthenticated and is limited to repositories accessible without credentials.
>
> #### Input Parameters
>
> **namespace** `string` *required*
>
> The user or organization namespace that owns the repository (e.g., 'library' for official images, or a username/org name)
>
> **repository** `string` *required*
>
> The name of the repository to retrieve (e.g., 'ubuntu', 'nginx', 'alpine')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Docker Hub Tag
>
> **Slug:** `DOCKER_HUB_GET_TAG`
>
> Retrieve details of a specific Docker Hub repository tag by namespace, repository, and tag name. The request is unauthenticated and is limited to tags accessible without credentials.
>
> #### Input Parameters
>
> **tag** `string` *required*
>
> Specific tag name to retrieve details for
>
> **namespace** `string` *required*
>
> User or organization namespace that owns the repository. Use 'library' for official Docker images.
>
> **repository** `string` *required*
>
> Name of the repository within the namespace
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Docker Hub Team
>
> **Slug:** `DOCKER_HUB_GET_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.
>
> #### Input Parameters
>
> **org\_name** `string` *required*
>
> The slug/name of the organization that owns the team (e.g., 'my-organization')
>
> **team\_name** `string` *required*
>
> The slug/name of the team (group) to retrieve (e.g., 'developers')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Docker Hub Webhook
>
> **Slug:** `DOCKER_HUB_GET_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.
>
> #### Input Parameters
>
> **namespace** `string` *required*
>
> The Docker Hub namespace (username or organization name) that owns the repository. Must be a namespace you have admin/write access to.
>
> **repository** `string` *required*
>
> The name of the repository containing the webhook. The repository must exist under the specified namespace.
>
> **webhook\_id** `integer` *required*
>
> The unique numeric ID of the webhook to retrieve. Can be obtained from the list webhooks action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organization Access Tokens
>
> **Slug:** `DOCKER_HUB_LIST_ORG_ACCESS_TOKENS`
>
> List a page of organization access tokens for a Docker Hub organization, with pagination. Appropriate organization permissions are required.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the organization whose access tokens are to be listed. You must have appropriate permissions to view tokens for this organization.
>
> **page** `integer`
>
> Page number for paginated results (1-indexed, must be >= 1)
>
> **page\_size** `integer`
>
> Number of results per page (1-100, default 10)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Docker Hub Organizations
>
> **Slug:** `DOCKER_HUB_LIST_ORGANIZATIONS`
>
> List Docker Hub organizations associated with the authenticated user, with available organization details in paginated results. Use this to discover organizations before performing organization-specific operations.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed)
>
> **page\_size** `integer`
>
> Number of results per page (1-100)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Docker Hub Organization Members
>
> **Slug:** `DOCKER_HUB_LIST_ORG_MEMBERS`
>
> List members of a Docker Hub organization with available roles and details, using paginated results. Use this to review organization membership; access to the organization and appropriate authentication are required.
>
> #### Input Parameters
>
> **org** `string` *required*
>
> Name of the Docker Hub organization to list members from. Must be an organization you have access to (owner or member role).
>
> **page** `integer`
>
> Page number for pagination (1-indexed). Use with page\_size to navigate large member lists.
>
> **page\_size** `integer`
>
> Number of members to return per page (1-100). Default is 25.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Docker Hub Repositories
>
> **Slug:** `DOCKER_HUB_LIST_REPOSITORIES`
>
> List repositories under a Docker Hub namespace with optional filtering and pagination. The request is unauthenticated, so results are limited to repositories available without credentials.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number (1-indexed, must be >= 1)
>
> **ordering** `string`
>
> Sort key for ordering results. Valid values: 'name', 'last\_updated', 'pull\_count'. Prefix with '-' for descending order (e.g., '-last\_updated' for newest first).
>
> **namespace** `string` *required*
>
> The user or organization namespace to list repositories from
>
> **page\_size** `integer`
>
> Number of results per page (1-100, default 25)
>
> **media\_types** `string`
>
> Comma-separated list of media types to filter repositories
>
> **content\_types** `string`
>
> Comma-separated list of content types to filter repositories that contain at least one artifact of those types
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Team Members
>
> **Slug:** `DOCKER_HUB_LIST_TEAM_MEMBERS`
>
> List members of a Docker Hub team (group) within an organization, returning paginated user details. Optionally search for members; organization access and appropriate permissions are required.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results (starts at 1)
>
> **search** `string`
>
> Filter members by username, full name, or email (optional)
>
> **org\_name** `string` *required*
>
> Name of the Docker Hub organization (e.g., 'my-organization')
>
> **page\_size** `integer`
>
> Number of results per page (1-100, default 25)
>
> **team\_name** `string` *required*
>
> Name of the team (group) within the organization (e.g., 'developers')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Organization Teams
>
> **Slug:** `DOCKER_HUB_LIST_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.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results (1-indexed)
>
> **page\_size** `integer`
>
> Number of results per page (1-100)
>
> **organization** `string` *required*
>
> The slug/name of the organization whose teams are to be listed. You must be a member of this organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Docker Hub repository webhooks
>
> **Slug:** `DOCKER_HUB_LIST_WEBHOOKS`
>
> List webhooks configured for a Docker Hub repository, returning paginated configuration details. An empty result can also reflect an empty or unrecognized response format.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results. Starts at 1. If not specified, returns the first page.
>
> **namespace** `string` *required*
>
> The Docker Hub namespace (username or organization name) that owns the repository. Must be a namespace you have admin/write access to.
>
> **page\_size** `integer`
>
> Number of webhooks to return per page. Defaults to the API's default page size if not specified.
>
> **repository** `string` *required*
>
> The name of the repository to list webhooks for. The repository must exist under the specified namespace.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Organization Member
>
> **Slug:** `DOCKER_HUB_REMOVE_ORG_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.
>
> #### Input Parameters
>
> **org\_name** `string` *required*
>
> The unique name (namespace) of the Docker Hub organization from which to remove the member. Must be an organization you have admin access to.
>
> **username** `string` *required*
>
> The Docker Hub username of the member to remove from the organization. This user must currently be a member of the specified organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Team Member
>
> **Slug:** `DOCKER_HUB_REMOVE_TEAM_MEMBER`
>
> Remove a user from a Docker Hub organization team (group), revoking that team membership. The action reports success when the membership is absent, including when the team or organization does not exist.
>
> #### Input Parameters
>
> **org\_name** `string` *required*
>
> Name of the Docker Hub organization that owns the team
>
> **username** `string` *required*
>
> Docker Hub username of the member to remove from the team
>
> **team\_slug** `string` *required*
>
> Slug (URL-friendly name) of the team/group within the organization. This is typically the lowercase team name with spaces replaced by hyphens.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
