GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

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 workflows for CI/CD pipelines, release management, or version tracking.

Use Case Examples

  1. Fetch all tags of a GitLab project to display in a dashboard.
  2. Automate the retrieval of the latest tags for deployment scripts.

Properties

Name Meaning
Skip Authentication If true, the node skips authentication when making the API request.
Authentication The authentication method used for the API request, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to connect to, default is https://gitlab.com.
Method HTTP method used for the API request, default is GET.
Parameter Schema Defines the parameters for the API request including project ID, sorting, ordering, search, pagination, and items per page.
Query Parameters Optional query parameters to customize the API request such as sort order, search term, pagination tokens, and page size.
Path Parameters Path parameters for the API request, specifically the project ID or URL-encoded path.

Output

JSON

  • id - The ID or URL-encoded path of the project for which tags are retrieved.
  • sort - Sort order of the tags by update time, ascending or descending.
  • order_by - Field by which to order tags, such as name, updated time, or version.
  • search - Search term to filter tags by name.
  • page_token - Pagination token to start listing tags from a specific tag name.
  • page - Current page number of the paginated results.
  • per_page - Number of tags to return per page.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID or URL-encoded path is correct and accessible with the provided credentials.
  • Verify that the GitLab API base URL is correct, especially if using a self-hosted GitLab instance.
  • Check that the authentication token has sufficient permissions to access repository tags.
  • Pagination parameters must be valid integers; invalid values may cause errors or empty results.

Links

Discussion