GitLab API icon

GitLab API

Gitlab

Actions917

Overview

This node interacts with the GitLab API to create a new repository tag for a specified project. It is useful for automating version control workflows, such as tagging releases or marking specific points in the project history. For example, it can be used to programmatically add tags to a GitLab project repository during a CI/CD pipeline.

Use Case Examples

  1. Creating a new tag in a GitLab project repository to mark a release version.
  2. Automating tagging of commits in a project repository based on deployment events.

Properties

Name Meaning
Skip Authentication Option to skip authentication when making the API request.
Authentication Type of authentication used for the API request, defaulting 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 but POST is used for creating tags.
Path Parameters Parameters included in the request path, specifically the project ID or URL-encoded path to identify the project repository where the tag will be created.

Output

JSON

  • id - The ID or URL-encoded path of the project where the tag is created.
  • tag_name - The name of the tag created in the repository.
  • message - Optional message associated with the tag.
  • release_description - Description of the release associated with the tag.
  • commit_sha - The commit SHA the tag points to.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID or URL-encoded path is correct to avoid 404 errors.
  • Verify that the authentication token has sufficient permissions to create tags in the repository.
  • Check the request body schema to ensure all required fields for creating a tag are provided.
  • If skipping authentication, ensure the GitLab instance allows unauthenticated requests for this operation.

Discussion