GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation deletes a specific project hook in a GitLab project using the GitLab API. It is useful for managing project webhooks by removing those that are no longer needed or valid. For example, if a webhook was set up to notify an external service about project events but the service is no longer used, this operation can remove that webhook to keep the project configuration clean.

Use Case Examples

  1. Deleting a webhook from a GitLab project to stop notifications to an external service.
  2. Automating cleanup of project hooks when decommissioning projects or services.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request.
Authentication The authentication method used for the API request, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance, default is https://gitlab.com.
Method The HTTP method to use for the request, default is GET but DELETE is used for this operation.
Path Parameters Parameters required in the URL path to identify the project and the hook to delete.

Output

JSON

  • statusCode - HTTP status code of the delete operation response.
  • responseBody - Response body returned by the GitLab API after deleting the project hook.

Dependencies

  • GitLab API key credential for authentication.

Troubleshooting

  • Ensure the project ID and hook ID are correct and exist in the GitLab instance.
  • Check that the API key has sufficient permissions to delete project hooks.
  • If skipping authentication, the request will likely fail unless the GitLab instance allows unauthenticated deletes (rare).
  • Common error messages include 404 Not Found if the project or hook does not exist, and 403 Forbidden if the API key lacks permissions.

Links

Discussion