GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation deletes a specific integration from a GitLab group using the GitLab API. It is useful for automating the management of group integrations, such as removing outdated or unused integrations programmatically. For example, a user can delete an integration like Slack or Jira from a group by specifying the group ID and the integration slug.

Use Case Examples

  1. Deleting the Slack integration from a GitLab group with a given group ID.
  2. Removing the Jira integration from a specific GitLab group to stop issue tracking integration.

Properties

Name Meaning
Skip Authentication If set to true, the node will skip using authentication for the API request.
Authentication The authentication method used for the API request, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method The HTTP method used for the request, default is DELETE for this operation.
Parameter Schema Defines the path parameters required for the API call, including the integration slug and group ID.
Request Path The API endpoint path template for deleting the integration, /api/v4/groups/{id}/integrations/{slug}.
Path Parameters Collection of path parameters where 'slug' is the integration name and 'id' is the group ID.

Output

JSON

  • status - The HTTP status code of the delete operation response.
  • message - A message indicating the result of the delete operation, such as success or error details.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the group ID and integration slug are correct and exist in the GitLab instance.
  • Verify that the API token has sufficient permissions to delete group integrations.
  • Check the base URL if using a self-hosted GitLab instance to ensure it is correct.
  • Common error messages include 404 Not Found if the group or integration does not exist, and 403 Forbidden if the API token lacks permissions.

Links

Discussion