Delete a project template
Delete a template, every version it holds and every tag that names one. This cannot be undone.
- A pending or running build of the template is cancelled, with the reason
the template was deleted. - The reply counts the build records of the template. They stay readable by build id for 90 days, and their logs for seven days.
- While a sandbox records any of those versions, the delete returns 409. 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.
- To refuse a create from the template and keep every version as it is, archive the template instead.
Requires the project admin role.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Organization name
Project name
Template name
length <= 80Response Body
application/json
application/problem+json
curl -X DELETE "https://example.com/v1/orgs/string/projects/string/templates/string"{ "builds": 12}{ "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 an organization template DELETE
Delete a template, every version it holds and every tag that names one. This cannot be undone. - A pending or running build of the template is cancelled, with the reason `the template was deleted`. - The reply counts the build records of the template. They stay readable by build id for 90 days, and their logs for seven days. - While a sandbox records any of those versions, the delete returns 409. 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. - To refuse a create from the template and keep every version as it is, archive the template instead. Requires the organization admin or owner role.
Get an organization template GET
Get one organization template by name. Requires organization membership.