share_dashboard

Mark a saved dashboard as shared with the project team and return an authenticated app URL. The URL can only be opened by users who already have Bridge Town access to the project — no anonymous or public access is granted. Requires at least Editor access to the project. expires_hours: enforced sharing duration in hours (1–, default 24).

Parameters

Name	Type	Required	Default	Description
project_name	Annotated[str, Field(description='Name of the Bridge Town project.')]	Yes	—
dashboard_name	Annotated[str, Field(description='Name of the dashboard to share.')]	Yes	—
expires_hours	Annotated[int, Field(description=f'Sharing policy duration in hours (1–{_MAX_EXPIRES_HOURS}, default: 24). Values outside this range raise a validation error.')]	No	24

Returns

Returns a structured object. Top-level fields:

• dashboard_id (string)
• dashboard_name (string)
• project (string)
• dashboard_url (string)
• access_note (string)
• expires_hours (integer)
• share_expires_at (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "share_dashboard",
  "arguments": {
    "project_name": "forecasts",
    "dashboard_name": "ARR Bridge",
    "expires_hours": 48
  }
}

Response

{
  "dashboard_id": "77777777-7777-7777-7777-777777777777",
  "dashboard_name": "ARR Bridge",
  "project": "forecasts",
  "dashboard_url": "https://app.bridgetown.builders/projects/forecasts/dashboards/77777777-7777-7777-7777-777777777777",
  "access_note": "This URL requires the recipient to be a project collaborator on 'forecasts' with a Bridge Town account. No anonymous access is granted.",
  "expires_hours": 48,
  "share_expires_at": "2026-03-31T10:00:00+00:00"
}

Notes

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