List an organization 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 organization membership.
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 organization membership.
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 <= 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/orgs/string/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"}Get one version of a system template GET
Get one version of this template by id, with the tags on it and the build that published it. A version id that belongs to another template answers 404. Requires no role: the catalogue belongs to the platform, and every caller reads it.
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.