Check repository tag
HEAD
/v2/namespaces/{namespace}/repositories/{repository}/tags/{tag} Checks whether the specified tag exists in the repository.
This operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.
Connection and access
API connection and authentication guidance
https://hub.docker.com
—
Docker HUB API
Use one of these alternatives. Requirements within an alternative apply together.
bearerAuth
Parameters
namespace
path
Required
Namespace of the repository, such as a user or organization name.
Type:
string
All schema constraints and annotations
{
"type": "string"
}repository
path
Required
Name of the repository within the namespace.
Type:
string
All schema constraints and annotations
{
"type": "string"
}tag
path
Required
Name of the image tag.
Type:
string
All schema constraints and annotations
{
"type": "string"
}Request and responses
Response
200
Repository tag exists
No response content is declared.
Response
403
Forbidden
application/json
Schema:
error
error
{
"errinfo": null,
"message": "permission denied"
}Response
404
Not Found
application/json
Schema:
error
error
{
"errinfo": null,
"message": "not found"
}Referenced schemas
Complete operation contract
{
"description": "Checks whether the specified tag exists in the repository.\n\nThis operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.\n",
"operationId": "headV2NamespacesByNamespaceRepositoriesByRepositoryTagsByTag",
"responses": {
"200": {
"description": "Repository tag exists"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
}
},
"security": [
{
"bearerAuth": []
}
],
"summary": "Check repository tag",
"tags": [
"repositories"
]
}