GitLab API

GitlabTool

Actions1000

Overview

This node operation updates the Pivotal Tracker integration settings for a specific GitLab group by sending a PUT request to the GitLab API endpoint `/api/v4/groups/{id}/integrations/pivotaltracker`. It is useful for automating the configuration of Pivotal Tracker integration within GitLab groups, such as enabling or modifying integration parameters programmatically.

Use Case Examples

  1. Automatically update Pivotal Tracker integration settings for a GitLab group as part of a CI/CD pipeline.
  2. Manage multiple GitLab groups' Pivotal Tracker integrations in bulk via workflow automation.

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 key authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request, default is PUT for this operation.
Path Parameters The path parameters required for the API endpoint, specifically the group ID to identify which group's Pivotal Tracker integration to update.

Output

JSON

  • id - The ID of the GitLab group whose Pivotal Tracker integration was updated.
  • integrationStatus - The status or result of the Pivotal Tracker integration update operation.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the provided group ID is valid and the user has permission to update integrations for that group.
  • Verify that the GitLab API key credential is correctly configured and has sufficient scopes to perform integration updates.
  • Check the base URL to ensure it points to the correct GitLab instance.
  • Common error messages include authentication failures, invalid group ID, or insufficient permissions. Resolving these typically involves verifying credentials, permissions, and input parameters.

Links

Discussion