list_merge_requests
Retrieve merge requests from a GitLab project with filtering options by state, branch, assignee, author, search terms, and scope to manage code review workflows.
Instructions
List merge requests in a project
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assignee_id | No | Filter by assignee user ID | |
| author_id | No | Filter by author user ID | |
| per_page | No | Number of results per page (max 100) | |
| project_id | Yes | Project ID or path | |
| scope | No | Return merge requests with the given scope (optional) | |
| search | No | Search merge requests by title and description | |
| source_branch | No | Filter by source branch | |
| state | No | Filter by merge request state | opened |
| target_branch | No | Filter by target branch |
Input Schema (JSON Schema)
{
"properties": {
"assignee_id": {
"description": "Filter by assignee user ID",
"type": "number"
},
"author_id": {
"description": "Filter by author user ID",
"type": "number"
},
"per_page": {
"default": 20,
"description": "Number of results per page (max 100)",
"maximum": 100,
"type": "number"
},
"project_id": {
"description": "Project ID or path",
"type": "string"
},
"scope": {
"description": "Return merge requests with the given scope (optional)",
"enum": [
"created_by_me",
"assigned_to_me",
"all"
],
"type": "string"
},
"search": {
"description": "Search merge requests by title and description",
"type": "string"
},
"source_branch": {
"description": "Filter by source branch",
"type": "string"
},
"state": {
"default": "opened",
"description": "Filter by merge request state",
"enum": [
"opened",
"closed",
"merged",
"all"
],
"type": "string"
},
"target_branch": {
"description": "Filter by target branch",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
}