GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation updates a specific project topic in GitLab by sending a PUT request to the GitLab API endpoint `/api/v4/topics/{id}`. It is useful for modifying details of an existing topic identified by its ID, such as changing the topic's name or description.

Use Case Examples

  1. Updating the name or description of a project topic in GitLab by specifying the topic ID and the new data.
  2. Automating topic management in GitLab projects by programmatically updating topic information.

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, defaulting to https://gitlab.com.
Method The HTTP method to use for the request, defaulting to GET but settable to PUT for this operation.
Path Parameters The path parameters for the request, specifically the `id` of the project 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 - The timestamp when the topic was created.
  • updated_at - The timestamp when the topic was last updated.

Dependencies

  • GitLab API authentication token

Troubleshooting

  • Ensure the `id` path parameter is correctly provided and corresponds to an existing topic in GitLab.
  • Verify that the authentication token is valid and has sufficient permissions to update topics.
  • Check the base URL to ensure it points to the correct GitLab instance.
  • Common error messages include 404 Not Found if the topic ID does not exist, 401 Unauthorized if authentication fails, and 400 Bad Request if the request body is malformed.

Links

Discussion