GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves raw artifact files from a specific job in a GitLab project. It is useful for accessing build or test artifacts stored in GitLab CI/CD pipelines, such as logs, reports, or compiled binaries. For example, a user can fetch a specific artifact file from a job on a particular branch or tag of a project to analyze build results or deploy artifacts.

Use Case Examples

  1. Fetch a test report artifact from the 'test' job on the 'main' branch of a project.
  2. Download a compiled binary artifact from a CI job for deployment purposes.

Properties

Name Meaning
Skip Authentication Option to skip authentication when making the API request.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request (GET, POST, PUT, DELETE, HEAD, PATCH).
Query Parameters Parameters sent as query strings in the request URL.
Path Parameters Parameters included in the URL path to specify the project and reference.

Output

JSON

  • id - The ID or URL-encoded path of the project.
  • ref_name - Branch or tag name in the repository.
  • job - The name of the job whose artifact is retrieved.
  • artifact_path - Path to the file inside the artifacts archive.
  • job_token - Optional token for multi-project pipeline triggers.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the project ID and reference name are correct and URL-encoded if necessary.
  • Verify that the job name and artifact path exist and are accessible in the specified project and branch/tag.
  • Check that authentication credentials are valid and have sufficient permissions to access the project's job artifacts.
  • If using job_token, confirm that the GitLab tier supports this feature (Premium or Ultimate).

Links

Discussion