docker.com – hub
Docker Hub is a service provided by Docker for finding and sharing container images with your team.
It is the world's largest library and community for container images.
In addition to the and (currently experimental),
Docker provides an API that allows you to interact with Docker Hub.
Browse through the Docker Hub API documentation to explore the supported endpoints.
- Homepage
- https://api.apis.guru/v2/specs/docker.com:hub/beta.json
- Provider
- docker.com:hub / hub
- OpenAPI version
- 3.0.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/docker.com/hub/beta/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/docker.com/hub/beta/openapi.yaml
Tools (30)
Extracted live via the executor SDK.
-
accessTokens.deleteV2AccessTokensUuidDeletes a personal access token permanently. This cannot be undone.
-
accessTokens.getV2AccessTokensReturns a paginated list of personal access tokens.
-
accessTokens.getV2AccessTokensUuidReturns a personal access token by UUID.
-
accessTokens.patchV2AccessTokensUuidUpdates a personal access token partially. You can either update the token's label or enable/disable it.
-
accessTokens.postV2AccessTokensCreates and returns a personal access token.
-
auditLogs.auditLogsGetAuditActionsGet audit log actions for a namespace to be used as a filter for querying audit events.
-
auditLogs.auditLogsGetAuditLogsGet audit log events for a given namespace.
-
authentication.postUsers2FaLoginWhen user has 2FA enabled, this is the second call to perform after
/v2/users/logincall.Creates and returns a bearer token in JWT format that you can use to authenticate with Docker Hub APIs.
The returned token is used in the HTTP Authorization header like
Authorization: Bearer {TOKEN}.Most Docker Hub APIs require this token either to consume or to get detailed information. For example, to list images in a private repository.
-
authentication.postUsersLoginCreates and returns a bearer token in JWT format that you can use to authenticate with Docker Hub APIs.
The returned token is used in the HTTP Authorization header like
Authorization: Bearer {TOKEN}.Most Docker Hub APIs require this token either to consume or to get detailed information. For example, to list images in a private repository.
-
images.getNamespacesRepositoriesImagesGets details on the images in a repository.
-
images.getNamespacesRepositoriesImagesSummaryGets the number of images in a repository and the number of images counted as active and inactive.
-
images.getNamespacesRepositoriesImagesTagsGets current and historical tags for an image.
-
images.postNamespacesDeleteImagesDeletes one or more images within a namespace. This is currently limited to a single repository.
If you attempt to delete images that are marked as active or are currently tagged, the deletion does not happen and it displays the warnings. To continue with the deletion, you must ignore these warnings by putting them in the
ignore_warningsproperty.Deleting a currently tagged image deletes the tag from the repository.
You cannot ignore errors. It is not possible to directly delete children of multi-arch images.
-
orgSettings.getV2OrgsNameSettingsReturns organization settings by name.
-
orgSettings.putV2OrgsNameSettingsUpdates an organization's settings. Some settings are only used when the organization is on a business plan.
Only users in the "owners" group of the organization can use this endpoint.
The following settings are only used on a business plan:
restricted_images
-
repositories.getV2NamespacesNamespaceRepositoriesRepositoryTagsList repository tags
-
repositories.getV2NamespacesNamespaceRepositoriesRepositoryTagsTagRead repository tag
-
repositories.headV2NamespacesNamespaceRepositoriesRepositoryTagsCheck repository tags
-
repositories.headV2NamespacesNamespaceRepositoriesRepositoryTagsTagCheck repository tag
-
scim.getV2Scim20ResourceTypesReturns all resource types supported for the SCIM configuration.
-
scim.getV2Scim20ResourceTypesNameReturns a resource type by name.
-
scim.getV2Scim20SchemasReturns all schemas supported for the SCIM configuration.
-
scim.getV2Scim20SchemasIdReturns a schema by ID.
-
scim.getV2Scim20ServiceProviderConfigReturns a service provider config for Docker's configuration.
-
scim.getV2Scim20UsersList users, returns paginated users for an organization. Use
startIndexandcountquery parameters to receive paginated results.Sorting:
Sorting lets you to specify the order of returned resources by specifying a combination ofsortByandsortOrderquery parameters.The
sortByparameter specifies the attribute whose value will be used to order the returned responses. ThesortOrderparameter defines the order in which thesortByparameter is applied. Allowed values are "ascending" and "descending".Filtering:
You can request a subset of resources by specifying thefilterquery parameter containing a filter expression. Attribute names and attribute operators used in filters are case insensitive. The filter parameter must contain at least one valid expression. Each expression must contain an attribute name followed by an attribute operator and an optional value.Supported operators are listed below.
eqequalnenot equalcocontainsswstarts withandLogical "and"orLogical "or"not"Not" function()Precedence grouping
-
scim.getV2Scim20UsersIdReturns a user by ID.
-
scim.postV2Scim20UsersCreates a user. If the user already exists by email, they are assigned to the organization on the "company" team.
-
scim.putV2Scim20UsersIdUpdates a user. Use this route to change the user's name, activate, and deactivate the user.
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools