GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves repository tags for a specific project from the GitLab API (v4). It is useful for scenarios where you need to list or manage tags in a GitLab project's repository, such as automation scripts for CI/CD pipelines, release management, or auditing repository states.

Use Case Examples

  1. Fetch all tags of a project to display in a dashboard.
  2. Retrieve tags sorted by update time to identify the latest releases.
  3. Search for tags matching specific criteria to automate deployment processes.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public repositories or testing.
Authentication Type of authentication used, defaults to 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.
Query Parameters Optional query parameters to filter and paginate the tags list, including sort order, order by field, search term, pagination token, page number, and items per page.
Path Parameters Path parameter specifying the project ID or URL-encoded path to identify the project whose tags are being retrieved.

Output

JSON

  • id - The unique identifier of the tag.
  • name - The name of the tag.
  • message - The message associated with the tag, if any.
  • target - The commit SHA or reference the tag points to.
  • commit
    • id - The commit ID the tag points to.
    • short_id - Shortened commit ID.
    • title - Commit title message.
    • 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, if associated.
    • description - Description of the release associated with the tag.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the project ID or URL-encoded path is correct to avoid 404 errors.
  • Verify authentication credentials if not skipping authentication to prevent authorization errors.
  • Check query parameter values for correct types and valid options to avoid request failures.
  • If pagination is used, ensure page tokens and page numbers are correctly set to retrieve expected results.

Links

Discussion