GitLab API icon

GitLab API

Gitlab

Actions917

Overview

This node interacts with the GitLab API, specifically supporting the operation to update the Pivotal Tracker service settings for a GitLab project via a PUT request to the endpoint /api/v4/projects/{id}/services/pivotaltracker. It is useful for automating the configuration of project integrations with Pivotal Tracker in GitLab, such as enabling or modifying the integration settings programmatically.

Use Case Examples

  1. Automatically update Pivotal Tracker integration settings for a GitLab project when a new project is created.
  2. Modify the Pivotal Tracker service configuration for multiple projects in bulk via workflow automation.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public or unauthenticated endpoints.
Authentication Type of authentication used for the request, defaulting to GitLab API key authentication.
baseUrl Base URL for the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET but supports PUT for this operation.
Path Parameters Parameters to be included in the request path, specifically the project ID for this operation.

Output

JSON

  • response - The JSON response from the GitLab API after updating the Pivotal Tracker service settings for the specified project.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID path parameter is correctly set and corresponds to an existing project in GitLab.
  • Verify that the API key used has sufficient permissions to update project service settings.
  • Check that the baseUrl is correct if using a self-hosted GitLab instance.
  • Common error messages include 401 Unauthorized (invalid or missing API key), 404 Not Found (project ID does not exist), and 400 Bad Request (invalid request body). Resolving these involves correcting credentials, verifying project existence, and ensuring request body schema compliance.

Links

Discussion