Get an organization template
Get one organization template by name. Requires organization membership.
Get one organization template by name. 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 <= 80Response Body
application/json
application/problem+json
curl -X GET "https://example.com/v1/orgs/string/templates/string"{ "created_at": "2019-08-24T14:15:22Z", "id": "string", "metadata": { "description": "string", "display_name": "string", "name": "string" }, "reference": "go-dev", "scope": "system", "state": "active", "stats": { "builds": { "failed": 2, "succeeded": 5, "total": 8 }, "sandboxes": 3, "stored_bytes": 4187725824, "tags": 2, "versions": { "active": 3, "archived": 4 } }, "updated_at": "2019-08-24T14:15:22Z"}{ "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"}Delete a project template DELETE
Delete a template, every version it holds, every tag that names one and its build records, a running build included. The reply counts the build records it destroyed. That count is the part nothing else records: a build's status, its error and the resources it ran on live in that row alone, and its log stays in storage for seven days with nothing left to address it by. Read `stats.builds.total` on the template first to see the number before you delete. It is refused with 409 while a sandbox records any of those versions, and the refusal names up to 5 of them and counts the rest. A paused sandbox counts, and so does one whose teardown has not finished. There is no override: delete those sandboxes first. This cannot be undone: archive the template instead to refuse a create from it and keep every version as it is. Requires the project admin role.
Get a project template GET
Get one project template by name. Requires read access to the project.