List a system template's versions
List the template's versions, newest first. tagged=false finds a version published without moving a tag. Every version names the tags that resolve to it and the build that published it, so a caller needs neither list beside this one. q matches the start of a version id, or a word in the base image reference. 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.
List the template's versions, newest first. tagged=false finds a version published without moving a tag. Every version names the tags that resolve to it and the build that published it, so a caller needs neither list beside this one. q matches the start of a version id, or a word in the base image reference. 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.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Template name
length <= 80Query Parameters
Narrow to one state. Omit it for both.
Value in
- "active"
- "archived"
true for only the versions a tag points at, false for only the versions no tag points at. Omit it for both.
Filter by version id prefix, or by a word in the base image reference.
length <= 80Continue after this version id
length <= 64Page size, 50 by default
int321 <= value <= 200Response Body
application/json
application/problem+json
curl -X GET "https://example.com/v1/system-templates/string/versions"{ "items": [ { "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" ] } ], "pagination": { "has_more": true, "next_cursor": "string", "total_count": 0 }}{ "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 project template's versions GET
List the template's versions, newest first. `tagged=false` finds a version published without moving a tag. Every version names the tags that resolve to it and the build that published it, so a caller needs neither list beside this one. `q` matches the start of a version id, or a word in the base image reference. Send `q` with every page of a filtered list: the cursor carries the position, not the filter. Requires read access to the project.
Remove every unused version of an organization template PUT
Remove every unused version of this template in one call. A version is unused when no tag points at it and no sandbox records it, and a paused sandbox and a fork both count. A version's own state is not a test: an unused active version goes the same way an unused archived one does. Send `dry_run: true` to read back what a prune would remove, and remove nothing. It frees no storage on its own: the images are reclaimed later, once no version and no sandbox references them. Requires the organization admin or owner role.