remove_model_collaborator

Remove an active collaborator from a model using the grant_id returned by list_model_collaborators. Requires Owner role on the model. To cancel a pending invite instead, use manage_collaborator with action=‘cancel_invite’ and the grant_id returned by manage_collaborator’s action=‘invite’. Cannot remove the only model owner.

destructive

Parameters

Name	Type	Required	Default	Description
model_name	Annotated[str, Field(description='Name of the Bridge Town model. Caller must have Owner role.')]	Yes	—
grant_id	Annotated[str, Field(description='Opaque collaborator grant identifier returned by list_model_collaborators.')]	Yes	—
workspace_id	`Annotated[str	None, Field(description=WORKSPACE_ID_FIELD_DESCRIPTION)]`	No	None

Returns

Returns a structured object. Top-level fields:

• model (string)
• removed (boolean)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "remove_model_collaborator",
  "arguments": {
    "model_name": "forecasts",
    "grant_id": "99999999-9999-9999-9999-999999999999"
  }
}

Response

{
  "model": "forecasts",
  "removed": true
}

Notes

• Module: Collaborators
• Requires an authenticated Bridge Town session (OAuth) or an API token.