GitLab API

GitlabTool

Actions1000

Overview

This node operation downloads a secure file from a specified GitLab project using the GitLab API. It is useful for automating the retrieval of secure files stored in GitLab projects, such as certificates, keys, or other sensitive files, directly within an n8n workflow.

Use Case Examples

  1. Automatically download a secure file from a GitLab project to use in a deployment pipeline.
  2. Retrieve secure files for backup or auditing purposes within an automated workflow.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance to connect to, default is https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Path Parameters Parameters required in the URL path to specify the project and secure file to download.

Output

Binary

The node outputs the downloaded secure file as binary data, allowing it to be saved or processed further in the workflow.

JSON

  • fileName - The name of the downloaded secure file.
  • fileSize - The size of the downloaded file in bytes.
  • mimeType - The MIME type of the downloaded file.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the project ID and secure file ID are correct and accessible by the authenticated user.
  • Verify that the authentication credentials are valid and have sufficient permissions to access the secure file.
  • Check the base URL if using a self-hosted GitLab instance to ensure it is correct.
  • Common error messages include 401 Unauthorized (authentication failure), 404 Not Found (invalid project or file ID), and 403 Forbidden (insufficient permissions). Resolving these involves verifying credentials, IDs, and permissions.

Links

Discussion