List pull requests
bb_list_pull_requestsLists a repository's pull requests and filters by state, direction, or author, helping AI agents triage incoming and outgoing code review work.
Instructions
List pull requests of a repository. Filter by state (OPEN|MERGED|DECLINED|ALL), direction (INCOMING|OUTGOING) and optionally by author (client-side match on username or display name — paging metadata reflects unfiltered pages).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectKey": "<projectKey>",
"repositorySlug": "<repositorySlug>"
},
"name": "bb_list_pull_requests"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | One-based page number (Cloud only; from nextPageStart of the previous call). Ignored on Server/DC. | |
| limit | No | Page size (1-1000). | |
| start | No | Zero-based page offset (Server/DC). | |
| state | No | Pull request state filter. | OPEN |
| author | No | Filter by author username or display name (case-insensitive, client-side). | |
| direction | No | INCOMING: into this repository's branches; OUTGOING: from this repository's branches. | INCOMING |
| projectKey | Yes | Project key (on Cloud: workspace slug). | |
| repositorySlug | Yes | Repository slug, e.g. 'service-api'. |