GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation updates a project topic in GitLab by sending a PUT request to the GitLab API endpoint `/api/v4/topics/{id}`. It is useful for modifying existing topics by specifying the topic ID and providing the updated data in the request body. Common scenarios include managing project topics programmatically within automation workflows, such as updating topic names or descriptions.

Use Case Examples

  1. Updating a project topic's name and description by specifying the topic ID and new values.
  2. Automating topic management in GitLab projects as part of a CI/CD pipeline.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the request.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method The HTTP method to use for the request, defaulting to GET but set to PUT for this operation.
Path Parameters Parameters included in the request path, specifically the topic ID to identify which topic to update.

Output

JSON

  • id - The unique identifier of the updated topic.
  • name - The name of the updated topic.
  • description - The description of the updated topic.
  • created_at - Timestamp when the topic was created.
  • updated_at - Timestamp when the topic was last updated.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the topic ID provided in the path parameters is valid and exists in the GitLab instance.
  • Verify that the authentication credentials are correctly configured and have sufficient permissions to update topics.
  • Check the request body schema to ensure all required fields are included and correctly formatted.
  • Common error messages include 401 Unauthorized (authentication issues), 404 Not Found (invalid topic ID), and 400 Bad Request (invalid request body). Resolving these involves correcting credentials, verifying topic existence, and validating request data respectively.

Links

Discussion