gitlab_list_tags
Retrieve repository tags with commit information to identify releases and version history. Supports sorting by name, date, or semantic versioning.
Instructions
List repository tags Returns: Tags with commit info Use when: Finding releases, version tags Sorting: By name, date, semver
Example response: [{ "name": "v2.0.0", "message": "Version 2.0.0 release", "commit": { "id": "abc123...", "short_id": "abc123", "title": "Prepare 2.0.0 release" }, "release": { "tag_name": "v2.0.0", "description": "Major release with new features..." } }]
Related tools:
gitlab_list_releases: Full release info
gitlab_create_tag: Create new tag
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 | |
| order_by | No | Tag ordering field Type: string (enum) Options: - 'name': Alphabetical order - 'updated': Last updated first - 'version': Version string comparison - 'semver': Semantic version sorting Default: 'updated' Examples: - 'name': a-tag, b-tag, c-tag - 'semver': v1.0.0, v1.1.0, v2.0.0 | updated |
| 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 |