Skip to content

Files

Latest commit

 

History

History
66 lines (49 loc) · 1.47 KB

api-tag-changeTag.adoc

File metadata and controls

66 lines (49 loc) · 1.47 KB

changeTag

PUT /api/v1/repository/{repository}/tag/{tag}

Authorizations: oauth2_implicit (repo:write)

Path parameters

Type Name Description Schema

path

repository
required

The full path of the repository. e.g. namespace/name

string

path

tag
required

The name of the tag

string

Request body schema (application/json)

Makes changes to a specific tag

Name Description Schema

manifest_digest
optional

(If specified) The manifest digest to which the tag should point

expiration
optional

(If specified) The expiration for the image

Responses

HTTP Code Description Schema

201

Successful invocation

400

Bad Request

401

Session required

403

Unauthorized access

404

Not found

Example command

$ curl -X PUT \
  -H "Authorization: Bearer <bearer_token>" \
  -H "Content-Type: application/json" \
  --data '{
    "manifest_digest": "<manifest_digest>"
  }' \
  https://<quay-server.example.com>/api/v1/repository/<namespace>/<repository_name>/tag/<tag>