GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

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 workflows that clean up projects after completion or when a project is no longer needed.

Use Case Examples

  1. Deleting a project by specifying its ID to free up resources.
  2. Automating project cleanup in a CI/CD pipeline by removing projects after deployment.

Properties

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

Output

JSON

  • success - Indicates if the project was successfully deleted.
  • statusCode - HTTP status code returned by the API.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the project ID or URL-encoded path is correct and exists in the GitLab instance.
  • Verify that the API key used for authentication has sufficient permissions to delete projects.
  • Check the base URL to ensure it points to the correct GitLab instance.
  • Common error messages include 404 Not Found if the project does not exist, and 403 Forbidden if the API key lacks delete permissions.

Links

Discussion