gitlab_list_releases
Retrieve GitLab project releases with detailed information like assets, release notes, and links. Use to find versions and release notes, distinct from simple git tags. Supports sorting and pagination for efficient browsing.
Instructions
List project releases Returns: GitLab releases (not just tags) Use when: Finding versions, release notes Includes: Assets, release notes, links
Different from tags:
Releases have descriptions, assets
Tags are just git references
Related tools:
gitlab_list_tags: Simple tag list
gitlab_create_release: Create release
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order_by | No | Field to sort by Type: string (enum) Options vary by endpoint: - Commits: 'created_at', 'title' - Issues: 'created_at', 'updated_at', 'priority', 'due_date' - MRs: 'created_at', 'updated_at', 'title' Default: Usually 'created_at' Example: 'updated_at' to see recently modified items first | released_at |
| page | No | Page number for pagination Type: integer Range: ≥1 Default: 1 Example: 3 (to get the third page of results) Note: Use with per_page to navigate large result sets | |
| per_page | No | Number of results per page Type: integer Range: 1-100 Default: 20 Example: 50 (for faster browsing) Tip: Use smaller values (10-20) for detailed operations, larger (50-100) for listing | |
| project_id | No | Project identifier (auto-detected if not provided) Type: integer OR string Format: numeric ID or 'namespace/project' Optional: Yes - auto-detects from current git repository Examples: - 12345 (numeric ID) - 'gitlab-org/gitlab' (namespace/project path) - 'my-group/my-subgroup/my-project' (nested groups) Note: If in a git repo with GitLab remote, this can be omitted | |
| sort | No | Sort direction Type: string (enum) Options: 'asc' | 'desc' Default: Varies by context (usually 'desc' for time-based) Examples: - 'asc': A→Z, oldest→newest, smallest→largest - 'desc': Z→A, newest→oldest, largest→smallest | desc |
Input Schema (JSON Schema)
{
"properties": {
"order_by": {
"default": "released_at",
"description": "Field to sort by\nType: string (enum)\nOptions vary by endpoint:\n - Commits: 'created_at', 'title'\n - Issues: 'created_at', 'updated_at', 'priority', 'due_date'\n - MRs: 'created_at', 'updated_at', 'title'\nDefault: Usually 'created_at'\nExample: 'updated_at' to see recently modified items first",
"enum": [
"released_at",
"created_at"
],
"type": "string"
},
"page": {
"default": 1,
"description": "Page number for pagination\nType: integer\nRange: ≥1\nDefault: 1\nExample: 3 (to get the third page of results)\nNote: Use with per_page to navigate large result sets",
"minimum": 1,
"type": "integer"
},
"per_page": {
"default": 50,
"description": "Number of results per page\nType: integer\nRange: 1-100\nDefault: 20\nExample: 50 (for faster browsing)\nTip: Use smaller values (10-20) for detailed operations, larger (50-100) for listing",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"project_id": {
"description": "Project identifier (auto-detected if not provided)\nType: integer OR string\nFormat: numeric ID or 'namespace/project'\nOptional: Yes - auto-detects from current git repository\nExamples:\n - 12345 (numeric ID)\n - 'gitlab-org/gitlab' (namespace/project path)\n - 'my-group/my-subgroup/my-project' (nested groups)\nNote: If in a git repo with GitLab remote, this can be omitted",
"type": "string"
},
"sort": {
"default": "desc",
"description": "Sort direction\nType: string (enum)\nOptions: 'asc' | 'desc'\nDefault: Varies by context (usually 'desc' for time-based)\nExamples:\n - 'asc': A→Z, oldest→newest, smallest→largest\n - 'desc': Z→A, newest→oldest, largest→smallest",
"enum": [
"asc",
"desc"
],
"type": "string"
}
},
"type": "object"
}