GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation deletes a group in GitLab by its ID. It is useful for automating the management of GitLab groups, such as removing obsolete or unwanted groups programmatically. For example, a user can integrate this node in a workflow to clean up groups based on certain criteria without manual intervention.

Use Case Examples

  1. Deleting a GitLab group by specifying its ID to automate group management.
  2. Removing a group as part of a cleanup process in a CI/CD pipeline.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or if authentication is handled externally.
Authentication Type of authentication used for the request, defaulting to GitLab API key authentication.
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.
Path Parameters Parameters to be included in the request path, specifically the group ID to delete.

Output

JSON

  • success - Indicates if the group deletion was successful
  • statusCode - HTTP status code returned from the API
  • message - Additional message or error details from the API response

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the group ID provided in the path parameters is correct and exists in the GitLab instance.
  • Verify that the API key used has sufficient permissions to delete groups.
  • If skipping authentication, ensure the GitLab instance allows unauthenticated requests for this operation, which is uncommon.
  • Common error messages include 404 Not Found if the group ID does not exist, and 403 Forbidden if the API key lacks delete permissions.

Links

Discussion