GitLab API icon

GitLab API

Gitlab

Actions917

Overview

This node operation allows users to download a specific release asset file from a GitLab project release by specifying the project ID or path, the release tag name, and the direct path to the asset file. It is useful for automating the retrieval of release files from GitLab projects, such as binaries, archives, or other release assets, directly within an n8n workflow.

Use Case Examples

  1. Automatically download the latest release asset from a GitLab project for deployment.
  2. Fetch a specific release file from a GitLab project to integrate with a CI/CD pipeline.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication Type of authentication used, defaulting to GitLab API key authentication.
baseUrl Base URL of the GitLab instance, default is https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Parameter Schema Defines required path and query parameters for the API call, including project ID, release tag name, and direct asset path.
Request Body Schema Schema for the request body, null for this operation as it is a GET request.
Request Path API endpoint path template for downloading the release asset.
Query Parameters Collection of query parameters, specifically the direct_asset_path which specifies the file path to download.
Path Parameters Collection of path parameters including project ID and release tag name.

Output

JSON

  • id - The ID or URL-encoded path of the project.
  • tag_name - The Git tag the release is associated with.
  • direct_asset_path - The path to the file to download, as specified when creating the release asset.
  • downloadedFile - The content of the downloaded release asset file.

Dependencies

  • Requires GitLab API key credential for authentication unless skipping authentication.

Troubleshooting

  • Ensure the project ID and tag name are correctly URL-encoded and valid in GitLab.
  • Verify that the direct_asset_path matches exactly the path specified when the release asset was created.
  • Authentication errors may occur if the API key is missing or invalid; check credentials configuration.
  • Network or permission issues may prevent file download; verify access rights to the project and release assets.

Links

Discussion