create_model_from_template

Create a new customer-owned model from an official or workspace template. Any workspace member may call this tool. The new model starts with a full copy of the template’s code and version history. Data-source credentials and prior run outputs are NOT copied. Provenance is recorded so the new model’s origin is traceable. The calling user is granted Owner access to the new model.

Parameters

Name	Type	Required	Default	Description
template_model_name	Annotated[str, Field(description='Name of the existing model to use as a template source.')]	Yes	—
new_model_name	Annotated[str, Field(description='Name for the newly created model. Must be unique within the workspace.')]	Yes	—
description	Annotated[str, Field(description='Optional description for the new model.')]	No	''
branch	`Annotated[str	None, Field(description=“Branch in the template model to copy from. Defaults to the template’s default branch.”)]`	No	None
template_source_kind	Annotated[Literal['workspace', 'official'], Field(description='Template catalog source returned by list_templates. Defaults to workspace.')]	No	'workspace'
workspace_id	`Annotated[str	None, Field(description=WORKSPACE_ID_FIELD_DESCRIPTION)]`	No	None

Returns

Returns a structured object. Top-level fields:

• model (string)
• template_source (string)
• description (string)
• model_url (string)
• clone_url (string)
• workspace_id (string)
• provenance (object)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "create_model_from_template",
  "arguments": {
    "template_model_name": "saas-arr-template",
    "new_model_name": "forecasts",
    "description": "FY26 SaaS forecasts"
  }
}

Response

{
  "model": "forecasts",
  "template_source": "saas-arr-template",
  "description": "FY26 SaaS forecasts",
  "model_url": "https://app.bridgetown.builders/models/forecasts",
  "clone_url": "https://git.bridgetown.builders/acme/forecasts.git",
  "workspace_id": "dddddddd-dddd-dddd-dddd-dddddddddddd",
  "provenance": {
    "kind": "workspace",
    "template_id": "saas-arr-template"
  }
}

Notes

• Module: Templates
• Requires an authenticated Bridge Town session (OAuth) or an API token.