Every Scaffolder template has a tag: a stable, human-readable identifier that is unique within your workspace. Tags may contain lowercase letters, numbers, and dashes, and may not start or end with a dash. If you omit the tag when creating a template, Cortex derives one from the template’s name. An existing template keeps its tag unless you supply a new one.Operations that take a tagOrId path parameter accept either the tag or the unique, auto-generated Cortex ID. Prefer the tag: it is the identifier you choose, so it stays readable and portable across workspaces.
POST /api/v1/scaffolders is an upsert. If a template with the same tag already exists, that template is updated instead of a new one being created. Use PUT /api/v1/scaffolders/{tagOrId} when you want to update a specific template and have the request fail if it does not exist.
