GitLab API icon

GitLab API

Gitlab

Actions880

Overview

This node operation deletes a specific integration from a GitLab group using the GitLab API. It is useful for managing and cleaning up integrations associated with a group, such as removing obsolete or unwanted integrations like Slack, Jira, or Jenkins from a GitLab group.

Use Case Examples

  1. Deleting a Slack integration from a GitLab group to stop notifications.
  2. Removing a Jira integration from a group to disable issue tracking synchronization.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication The authentication method used for the API request, hidden unless Skip Authentication is false.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET but DELETE is used for this operation.
Parameter Schema Defines the path parameters required for the API call, including the integration slug and group ID.
Request Body Schema Schema for the request body, which is null for this delete operation.
Request Path The API endpoint path template for deleting the integration.
Path Parameters Collection of path parameters including 'slug' (integration name) and 'id' (group ID) required to identify the integration to delete.

Output

JSON

  • statusCode - HTTP status code of the API response indicating success or failure.
  • responseBody - The JSON response body from the API after attempting to delete the integration.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the 'id' parameter corresponds to a valid GitLab group ID and 'slug' matches an existing integration name; otherwise, the API will return an error.
  • If authentication is skipped, the request may fail due to lack of permissions.
  • Check that the baseUrl is correct and accessible.
  • Common error messages include 404 Not Found if the group or integration does not exist, and 401 Unauthorized if authentication fails.

Links

Discussion