SandboxesTemplatesTemplate management

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.

DELETE
/v1/orgs/{org}/projects/{project}/templates/{name}
AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

org*string

Organization name

project*string

Project name

name*string

Template name

Lengthlength <= 80

Response Body

application/json

application/problem+json

curl -X DELETE "https://example.com/v1/orgs/string/projects/string/templates/string"
{  "builds": 12}