Delete an organization 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 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 <= 80Response Body
application/json
application/problem+json
curl -X DELETE "https://example.com/v1/orgs/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"}Create a project template POST
Create a template scoped to the project, referenced as project/<name> or by the bare name. Requires the project admin role.
Delete a project 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 project admin role.