Skip to content

manage_workspace_template

Inspect, publish, or withdraw an existing model as a private template in its workspace. Publishing requires an active Pro plan and Owner access; withdrawal requires Owner access. This never publishes to the global official catalog or shares the model outside its workspace. Inspect first, then pass the returned revision to publish or withdraw; stale revisions are rejected.

NameTypeRequiredDefaultDescription
actionAnnotated[Literal['inspect', 'publish', 'withdraw'], Field(description='Inspect current status, publish the model, or withdraw it.')]Yes—
model_nameAnnotated[str, Field(description='Existing model whose workspace-template status should be managed.')]Yes—
template_descriptionAnnotated[str, Field(max_length=2048, description='Optional workspace-catalog description; used only when publishing.')]No''
expected_revision`Annotated[strNone, Field(min_length=1, max_length=64, description=“Revision returned by action=‘inspect’. Required for publish and withdraw; a stale revision is rejected unless the requested state is already applied.”)]`NoNone
workspace_id`Annotated[strNone, Field(description=WORKSPACE_ID_FIELD_DESCRIPTION)]`NoNone

Returns a structured object. Top-level fields:

  • operation_id (string)
  • action (string)
  • status (string)
  • model_name (string)
  • workspace_id (string)
  • is_template (boolean)
  • template_description (string)
  • revision (string)

See the response example below for the full payload shape.

{
"name": "manage_workspace_template",
"arguments": {
"action": "inspect",
"model_name": "saas-arr-template",
"workspace_id": "dddddddd-dddd-dddd-dddd-dddddddddddd"
}
}
{
"operation_id": "2b2978be-24c7-4b20-a7c1-16880c8f7ac2",
"action": "inspect",
"status": "inspected",
"model_name": "saas-arr-template",
"workspace_id": "dddddddd-dddd-dddd-dddd-dddddddddddd",
"is_template": true,
"template_description": "SaaS ARR forecast starter model",
"revision": "tpl_7f83b1657ff1fc53b92dc181"
}
  • Module: Templates
  • Requires an authenticated Bridge Town session (OAuth) or an API token.