GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation allows users to create a link between issues in a GitLab project by making a POST request to the GitLab API endpoint `/api/v4/projects/{id}/issues/{issue_iid}/links`. It is useful for managing issue relationships within a project, such as linking related issues for better tracking and organization.

Use Case Examples

  1. Linking two related issues in a GitLab project to track dependencies or duplicates.
  2. Creating an issue link to indicate that one issue blocks another.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication Type of authentication used, default is GitLab API key.
baseUrl Base URL of the GitLab instance, default is https://gitlab.com.
Method HTTP method to use for the request, default is GET but POST is used for this operation.
Path Parameters Parameters for the API path, including project ID and internal issue ID.

Output

JSON

  • id - The ID of the created issue link.
  • source_issue
    • id - The ID of the source issue in the link.
  • target_issue
    • id - The ID of the target issue in the link.
  • link_type - The type of link between the issues (e.g., relates_to, blocks).

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the project ID and issue internal ID are correct and accessible by the authenticated user.
  • Verify that the authentication token has the necessary permissions to create issue links in the project.
  • Check the request body schema to ensure all required fields for creating an issue link are provided.
  • Common error messages include 401 Unauthorized (authentication issues), 404 Not Found (invalid project or issue ID), and 400 Bad Request (invalid request body). Resolving these involves correcting credentials, IDs, or request data.

Links

Discussion