insert_google_sheet_rows

Insert rows into one explicit Google Sheet tab.

Parameters

Name	Type	Required	Default	Description
model_name	Annotated[str, Field(description='Name of the Bridge Town model.')]	Yes	—
sheet_id	Annotated[int, Field(ge=0, description='Numeric tab ID from metadata.')]	Yes	—
start_row	Annotated[int, Field(ge=0, description='Zero-based first row index.')]	Yes	—
num_rows	Annotated[int, Field(ge=1, le=10000, description='Rows to insert.')]	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
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": "insert_google_sheet_rows",
  "arguments": {
    "model_name": "forecasts",
    "sheet_id": 0,
    "start_row": 2,
    "num_rows": 3,
    "spreadsheet_id": "1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789ABCDEFG"
  }
}

Response

{
  "spreadsheet_id": "1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789ABCDEFG",
  "operation": "inserted",
  "detail": "Inserted 3 rows at index 2 in sheet 0."
}

Notes

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