request_model_share

Request to share a Bridge Town model with another tenant. Creates a pending share request that the target tenant must explicitly accept via accept_model_share_request. No model code is written to the target repo until acceptance.

Requires at least Viewer access to the source project. Requires Pro plan.

Parameters

Name	Type	Required	Default	Description
`source_project_name`	`str`	Yes	—	Project in the caller’s tenant containing the model
`model_name`	`str`	Yes	—	Model to share (without `.py`)
`target_tenant_slug`	`str`	Yes	—	Slug of the tenant to share with
`suggested_target_project`	`str`	Yes	—	Suggested destination project in the target tenant
`suggested_target_model`	`str`	No	`''`	Suggested model name. Defaults to `model_name`

Returns

request_id (string) — UUID of the pending share request
status (string) — always "pending" on success
source_project (string)
source_model (string)
target_tenant (string)
suggested_target_project (string)
suggested_target_model (string)
created_at (string) — ISO 8601 timestamp

Example

Tool Call

{
  "name": "request_model_share",
  "arguments": {
    "source_project_name": "platform",
    "model_name": "revenue_forecast",
    "target_tenant_slug": "partner-co",
    "suggested_target_project": "shared-models",
    "suggested_target_model": "acme_revenue_forecast"
  }
}

Response

{
  "request_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "status": "pending",
  "source_project": "platform",
  "source_model": "revenue_forecast",
  "target_tenant": "partner-co",
  "suggested_target_project": "shared-models",
  "suggested_target_model": "acme_revenue_forecast",
  "created_at": "2026-05-09T10:00:00+00:00"
}

Notes

Module: Sharing
Requires authentication via API token or Auth0 JWT.
The target tenant must call accept_model_share_request to receive the model.
Track the request with list_model_share_requests.