ensure_google_sheet_tab

Create a Google Sheet tab when it does not already exist.

Parameters

Name	Type	Required	Default	Description
model_name	Annotated[str, Field(description='Name of the Bridge Town model.')]	Yes	—
tab_title	Annotated[str, Field(min_length=1, max_length=100, description='Tab title to create if missing.')]	Yes	—
spreadsheet_id	`Annotated[str	None, Field(description=‘Google Spreadsheet ID; provide this or source_name.’)]`	No	None
source_name	`Annotated[str	None, Field(description=‘Connected Sheet data-source name; provide this or spreadsheet_id.’)]`	No	None
row_count	Annotated[int, Field(ge=1, le=10000)]	No	1000
column_count	Annotated[int, Field(ge=1, le=18278)]	No	26
workspace_id	`Annotated[str	None, Field(description=WORKSPACE_ID_FIELD_DESCRIPTION)]`	No	None

Returns

Returns a structured object. Top-level fields:

• spreadsheet_id (string)
• operation (string)
• detail (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "ensure_google_sheet_tab",
  "arguments": {
    "model_name": "forecasts",
    "tab_title": "Forecast",
    "spreadsheet_id": "1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789ABCDEFG"
  }
}

Response

{
  "spreadsheet_id": "1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789ABCDEFG",
  "operation": "exists",
  "detail": "Tab 'Forecast' already exists."
}

Notes

• Module: Google Sheets
• Requires authentication via API token or Auth0 JWT.