GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation retrieves detailed information about a specific tag in a GitLab project's repository using the GitLab API v4. It is useful for scenarios where you need to fetch metadata or details about a particular tag within a project, such as in CI/CD pipelines, release management, or version tracking.

Use Case Examples

  1. Fetch details of a release tag in a GitLab project to automate deployment processes.
  2. Retrieve tag metadata to display version information in a dashboard.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public projects or testing.
Authentication Type of authentication used, here it is GitLab API key authentication.
baseUrl Base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Path Parameters Parameters to specify the project ID or URL-encoded path and the tag name to fetch.

Output

JSON

  • id - Unique identifier of the tag
  • name - Name of the tag
  • message - Message associated with the tag, if any
  • target - Commit SHA the tag points to
  • commit
    • id - Commit ID associated with the tag
    • short_id - Shortened commit ID
    • title - Commit title
    • author_name - Name of the commit author
    • author_email - Email of the commit author
    • created_at - Timestamp when the commit was created
  • release
    • tag_name - Name of the release tag
    • description - Description of the release associated with the tag

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID and tag name are correctly URL-encoded to avoid 404 errors.
  • Authentication errors may occur if the API key is missing or invalid; verify credentials.
  • Check network connectivity and baseUrl correctness if requests fail to reach the GitLab server.

Links

Discussion