list_templates

List global official and published workspace templates available as a starting point for a new model. Call this first to discover valid template_model_name and source values before calling create_model_from_template — do not guess. Any workspace member may call this tool. Pass workspace_id to list templates in a workspace other than your current one (requires an active membership there; OAuth/JWT sessions only).

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
limit	Annotated[int, Field(ge=1, le=200, description='Maximum templates per page (default 50).')]	No	50
cursor	`Annotated[str	None, Field(description=‘Opaque continuation cursor from a previous list_templates response.’)]`	No	None
workspace_id	`Annotated[str	None, Field(description=WORKSPACE_ID_FIELD_DESCRIPTION)]`	No	None

Returns

Returns a structured object. Top-level fields:

• templates (array<object>)
• count (integer)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "list_templates",
  "arguments": {
    "workspace_id": "dddddddd-dddd-dddd-dddd-dddddddddddd"
  }
}

Response

{
  "templates": [
    {
      "model": "saas-arr-template",
      "template_description": "SaaS ARR forecast starter model",
      "source": "workspace"
    }
  ],
  "count": 1
}

Notes

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