submit_pull_request_review
Submit an explicit comment, approval, or change request on an identified pull request. For event=‘approve’, do this only after the user explicitly asks you to approve or adopt the change, or confirms the review. A request only to draft/open a PR, edit a model, or run it is not approval intent. PR creation never approves automatically.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
model_name | Annotated[str, Field(description='Name of the Bridge Town model.')] | Yes | — | |
pull_request_id | Annotated[int, Field(description='Numeric ID of the pull request within the model.')] | Yes | — | |
event | Annotated[Literal['comment', 'approve', 'request_changes'], Field(description="Review decision: 'comment' (leave a comment), 'approve' (approve the PR), or 'request_changes' (request changes). For 'approve', call only after the user explicitly asks you to approve/adopt the change or confirms the review; opening a PR, editing a model, or running it does not imply approval.")] | Yes | — | |
body | Annotated[str, Field(description="Review comment text. Required when event is 'COMMENT' or 'REQUEST_CHANGES'.")] | No | '' | |
workspace_id | `Annotated[str | None, Field(description=WORKSPACE_ID_FIELD_DESCRIPTION)]` | No | None |
Returns
Section titled “Returns”Returns a structured object. Top-level fields:
model(string)pull_request_id(integer)event(string)message(string)
See the response example below for the full payload shape.
Example
Section titled “Example”Tool Call
Section titled “Tool Call”{ "name": "submit_pull_request_review", "arguments": { "model_name": "forecasts", "pull_request_id": 42, "event": "approve", "body": "Numbers look right. LGTM." }}Response
Section titled “Response”{ "model": "forecasts", "pull_request_id": 42, "event": "approve", "message": "Review submitted."}- Module:
Pull Requests - Requires an authenticated Bridge Town session (OAuth) or an API token.