GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation deletes a project in GitLab by its ID or URL-encoded path. It is useful for automating project management tasks such as removing obsolete or unwanted projects from a GitLab instance. For example, it can be used in CI/CD workflows to clean up projects after completion or in administrative scripts to manage project lifecycle.

Use Case Examples

  1. Deleting a project by specifying its ID to free up resources.
  2. Automating project cleanup in GitLab after a project is archived or no longer needed.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the request.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance to which the request is sent.
Method HTTP method to use for the request, defaulting to GET but can be set to DELETE for this operation.
Path Parameters Parameters included in the request path, specifically the project ID or URL-encoded path to identify the project to delete.

Output

JSON

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

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the project ID or URL-encoded path is correct and exists in the GitLab instance to avoid 404 errors.
  • Verify that the authentication credentials have sufficient permissions to delete projects to prevent authorization errors.
  • Check the baseUrl is correctly set to the GitLab instance URL if using a self-hosted GitLab server.

Links

Discussion