GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation deletes a group in GitLab by its ID. It is useful for automating the removal of groups within a GitLab instance, such as cleaning up unused or obsolete groups programmatically.

Use Case Examples

  1. Automatically delete a GitLab group by specifying its ID to maintain an organized project structure.
  2. Integrate with a workflow that removes groups when certain conditions are met, such as project completion or user request.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or when authentication is handled externally.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the request is sent, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET but DELETE is relevant for this operation.
Path Parameters Parameters included in the request path, specifically the group ID to delete.

Output

JSON

  • statusCode - HTTP status code returned by the API indicating the result of the delete operation
  • responseBody - The body of the response from the API, typically empty or containing confirmation of deletion

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the group ID provided is valid and exists in the GitLab instance to avoid 404 errors.
  • Check that the API key used has sufficient permissions to delete groups to prevent authorization errors.
  • If skipping authentication, ensure the GitLab instance allows unauthenticated requests for this operation, which is uncommon.

Links

Discussion