Updatescaffolder
updateScaffolderReplace an existing Scaffolder template, found by tag or Cortex ID, with the request body. Fields you omit go back to their defaults and are not merged, so read the template with getScaffolder first. Passing a new tag renames the template. Needs the Configure Scaffolder permission.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Stable, human-readable identifier, unique within the workspace. Lowercase letters, numbers, and dashes; may not start or end with a dash. Derived from the name when omitted on creation; an existing template keeps its tag unless a new one is provided. | |
| name | Yes | Display name of the Scaffolder template | |
| type | Yes | The templating engine of the template | |
| labels | Yes | Descriptive labels used to group templates in the UI | |
| context | Yes | Explain why you're invoking this tool now and how its output will be used. Then state how this call supports your *overall objective* and fits into your broader plan across all tool calls (e.g., why this tool vs. others, and what step it unblocks). Never share any personal details or sensitive information. | |
| tagOrId | Yes | Entity identifier - can be a tag or CID | |
| session_id | Yes | Session continuity handle, one of two values: the ses_ ID issued for the task underway, or start. This server cannot link your calls between requests on its own, so session continuity travels in this parameter instead. If you were handed a session_id for this task — for example by the agent that spawned you — send that exact value from your first call. Otherwise send start on your first call; the server will issue an opaque correlation ID in the mcp_session field of the result, or in a text block at the start of the result beginning [session_id issued. Then send that exact ses_ value on every later call and hand it to any subagents working the same task. start always begins a new, unrelated task — never send it mid-task. If you send a value this server does not recognize, the result reports it: mcp_session.status of unrecognized, or a text block beginning [session_id unrecognized; re-send the ID issued for this task, or start if none was issued yet. Never invent a ses_ value. | |
| showReadme | Yes | Whether the template repository's README is shown before a run. Defaults to `false` | |
| description | No | Description of the Scaffolder template | |
| repoLocator | Yes | ||
| createYamlFile | Yes | Whether a cortex.yaml is generated for the created entity. Defaults to `true` | |
| publisherOptions | No | ||
| strictAliasUsage | Yes | Whether runs are restricted to the git configuration alias the template names. Defaults to `true` | |
| requireNewService | Yes | Whether running the template must create a new entity. Defaults to `true` | |
| requirePullRequest | Yes | Whether the template publishes via a pull request to an existing repository. Defaults to `false` |