GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation deletes a project topic in GitLab by its ID. It is useful for managing and cleaning up topics associated with projects in GitLab repositories. For example, if a topic is no longer relevant or was created by mistake, this operation allows users to remove it programmatically via the GitLab API.

Use Case Examples

  1. Deleting a specific project topic by providing its ID to keep the project topics organized.
  2. Automating cleanup of unused or deprecated topics in a GitLab project.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication Type of authentication used for the request, default is GitLab API key.
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 ID of the topic to delete.

Output

JSON

  • id - ID of the deleted project topic
  • message - Response message confirming deletion or error details

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the provided topic ID exists and is correct; otherwise, the API will return an error indicating the topic was not found.
  • Check that the API key has sufficient permissions to delete project topics in the GitLab instance.
  • If skipping authentication, the request will likely fail unless the GitLab instance allows anonymous deletions, which is uncommon.

Links

Discussion