list_issues
Retrieve and filter GitLab project issues by assignee, author, labels, state, date ranges, and other criteria to track project tasks and bugs.
Instructions
List issues in a GitLab project with filtering options
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Project ID or URL-encoded path | |
| assignee_id | No | Return issues assigned to the given user ID | |
| assignee_username | No | Return issues assigned to the given username | |
| author_id | No | Return issues created by the given user ID | |
| author_username | No | Return issues created by the given username | |
| confidential | No | Filter confidential or public issues | |
| created_after | No | Return issues created after the given time | |
| created_before | No | Return issues created before the given time | |
| due_date | No | Return issues that have the due date | |
| labels | No | Array of label names | |
| milestone | No | Milestone title | |
| scope | No | Return issues from a specific scope | |
| search | No | Search for specific terms | |
| state | No | Return issues with a specific state | |
| updated_after | No | Return issues updated after the given time | |
| updated_before | No | Return issues updated before the given time | |
| with_labels_details | No | Return more details for each label | |
| page | No | Page number for pagination (default: 1) | |
| per_page | No | Number of items per page (max: 100, default: 20) |
Input Schema (JSON Schema)
{
"properties": {
"assignee_id": {
"description": "Return issues assigned to the given user ID",
"type": "number"
},
"assignee_username": {
"description": "Return issues assigned to the given username",
"items": {
"type": "string"
},
"type": "array"
},
"author_id": {
"description": "Return issues created by the given user ID",
"type": "number"
},
"author_username": {
"description": "Return issues created by the given username",
"type": "string"
},
"confidential": {
"description": "Filter confidential or public issues",
"type": "boolean"
},
"created_after": {
"description": "Return issues created after the given time",
"type": "string"
},
"created_before": {
"description": "Return issues created before the given time",
"type": "string"
},
"due_date": {
"description": "Return issues that have the due date",
"type": "string"
},
"labels": {
"description": "Array of label names",
"items": {
"type": "string"
},
"type": "array"
},
"milestone": {
"description": "Milestone title",
"type": "string"
},
"page": {
"description": "Page number for pagination (default: 1)",
"type": "number"
},
"per_page": {
"description": "Number of items per page (max: 100, default: 20)",
"type": "number"
},
"project_id": {
"description": "Project ID or URL-encoded path",
"type": "string"
},
"scope": {
"description": "Return issues from a specific scope",
"enum": [
"created_by_me",
"assigned_to_me",
"all"
],
"type": "string"
},
"search": {
"description": "Search for specific terms",
"type": "string"
},
"state": {
"description": "Return issues with a specific state",
"enum": [
"opened",
"closed",
"all"
],
"type": "string"
},
"updated_after": {
"description": "Return issues updated after the given time",
"type": "string"
},
"updated_before": {
"description": "Return issues updated before the given time",
"type": "string"
},
"with_labels_details": {
"description": "Return more details for each label",
"type": "boolean"
}
},
"required": [
"project_id"
],
"type": "object"
}