SandboxesSandbox TemplatesTemplate versions

Delete one version of an organization template

Delete one version. A sandbox that records this version blocks the delete, including a paused or stopped sandbox. The refusal counts them and names the first few by id. Every tag pointing at the version is deleted with it, so a reference like go-dev:stable stops resolving. The shared template image survives until no sandbox uses it. Requires the organization admin or owner role.

DELETE
/v1/orgs/{org}/templates/{name}/versions/{versionId}

Delete one version. A sandbox that records this version blocks the delete, including a paused or stopped sandbox. The refusal counts them and names the first few by id. Every tag pointing at the version is deleted with it, so a reference like go-dev:stable stops resolving. The shared template image survives until no sandbox uses it. Requires the organization admin or owner role.

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

name*string

Template name

Lengthlength <= 80
versionId*string

Template version id (ULID)

Length26 <= length <= 26

Response Body

application/problem+json

curl -X DELETE "https://example.com/v1/orgs/string/templates/string/versions/stringstringstringstringst"
Empty