GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation deletes a fork of a project in GitLab using the GitLab API. It is useful for managing project forks by removing them when they are no longer needed, helping to keep the project repository clean and organized. For example, a user can delete a forked project by specifying its ID or URL-encoded path.

Use Case Examples

  1. Deleting a forked project by providing its project ID to clean up unused forks.
  2. Automating the removal of project forks in a CI/CD pipeline to maintain repository hygiene.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication Type of authentication used, default is GitLab API authentication.
baseUrl Base URL of the GitLab instance, default is 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 project ID or URL-encoded path to identify the fork to delete.

Output

JSON

  • statusCode - HTTP status code of the response indicating success or failure of the delete operation.
  • body - Response body from the GitLab API after attempting to delete the project fork, typically empty or containing confirmation details.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the project ID or URL-encoded path is correctly provided in the path parameters; otherwise, the API call will fail.
  • Authentication errors may occur if the API token is missing, invalid, or lacks sufficient permissions to delete project forks.
  • HTTP method must be set to DELETE for this operation; using other methods may result in errors.

Links

Discussion