Skip to navigation

Delete Template

Delete a template owned by the caller’s workspace.

The delete is a soft delete — the record is hidden from the gallery and all visibility checks immediately, but is not physically removed. Any workflows previously cloned from this template are unaffected; clone creates an independent copy of the definition at clone time.

Restrictions:

  • Only the owning workspace may delete its templates (403 otherwise).
  • Platform starter templates (is_starter=true) cannot be deleted (403).

Requires workspace editor role or higher.

Authentication

AuthorizationBearer
Clerk JWT token

Path parameters

template_idstringRequiredformat: "^[A-Za-z0-9]{8}$"=8 characters

Case-sensitive 8-character base62 template identifier.

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response
datamap from strings to any
metaobject

Errors

422
Unprocessable Entity Error