Createorupdatescaffolder
createOrUpdateScaffolderCreate a Scaffolder template, or replace the one with the same tag. The request needs name and repoLocator; fields you omit go back to their defaults and are not merged. Without a tag a new template is always created, with a tag derived from the name. Needs the Configure Scaffolder permission. To update by Cortex ID or to rename a tag, use updateScaffolder.
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. | |
| 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` |