Move a tag of an organization template onto a version
Point a tag at one version of this template, creating the tag if it does not exist yet. The version may be older than the one the tag points at now, and it may be archived — a create through the tag then fails until the version is active again. A version that belongs to another template answers 404. The response carries the version the tag points at after the move. Requires the organization admin or owner role.
Point a tag at one version of this template, creating the tag if it does not exist yet. The version may be older than the one the tag points at now, and it may be archived — a create through the tag then fails until the version is active again. A version that belongs to another template answers 404. The response carries the version the tag points at after the move. Requires the organization admin or owner role.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Organization name
Template name
length <= 80Tag name
length <= 128Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The version this tag points at. It has to belong to this template.
26 <= length <= 26Response Body
application/json
application/problem+json
curl -X PUT "https://example.com/v1/orgs/string/templates/string/tags/string/move" \ -H "Content-Type: application/json" \ -d '{ "version_id": "stringstringstringstringst" }'{ "tag": "string", "version": { "archived_at": "2019-08-24T14:15:22Z", "archived_by": "user", "base_image": { "digest": "sha256:9f0b7c1e2d3a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4", "ref": "ghcr.io/tektona-ai/sandbox-base:0.5.0" }, "build_id": "01K2S8VVQ9F3M6WQ2S0S2Z9J4R", "creatable": true, "create_refused_by": "template", "created_at": "2019-08-24T14:15:22Z", "id": "string", "image_bytes": 0, "pending_rule": "archive", "pending_rule_at": "2019-08-24T14:15:22Z", "sandbox": { "default_resources": { "cpu": 2, "disk": 10, "memory": 2 }, "env": [ { "name": "string", "value": "string" } ], "user": "dev", "workdir": "/workspace" }, "state": "string", "tags": [ "default", "stable" ] }}{ "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}List a system template's tags GET
List the template's tags, in name order. A tag names the version a reference like go-dev:stable resolves to. Every tag carries that version in full, so a caller reads the state and the base image behind each name without listing the versions as well. `q` matches the start of a tag, or of the version id it points at. Send `q` with every page of a filtered list: the cursor carries the position, not the filter. Requires no role: the catalogue belongs to the platform, and every caller reads it.
Move a tag of a project template onto a version PUT
Point a tag at one version of this template, creating the tag if it does not exist yet. The version may be older than the one the tag points at now, and it may be archived — a create through the tag then fails until the version is active again. A version that belongs to another template answers 404. The response carries the version the tag points at after the move. Requires the project admin role.