GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation restores a deleted GitLab group by making a POST request to the GitLab API endpoint `/api/v4/groups/{id}/restore`. It is useful in scenarios where a previously deleted group needs to be recovered in a GitLab instance, such as restoring project collaboration environments or organizational units.

Use Case Examples

  1. Restoring a deleted group by specifying its group ID to recover access and settings.
  2. Automating group restoration as part of a recovery workflow in GitLab management.

Properties

Name Meaning
Skip Authentication Option to skip API authentication for the request.
Authentication Type of authentication used for the API request, defaulting to GitLab API key.
baseUrl Base URL of the GitLab instance to which the API request is sent, default is https://gitlab.com.
Method HTTP method used for the API request, default is GET but POST is used for this operation.
Path Parameters Parameters included in the API request path, specifically the group ID to restore.

Output

JSON

  • id - The unique identifier of the restored group.
  • name - The name of the restored group.
  • path - The path or URL slug of the restored group.
  • description - Description of the restored group.
  • visibility - Visibility level of the restored group (e.g., private, internal, public).
  • created_at - Timestamp when the group was originally created.
  • updated_at - Timestamp when the group was last updated.
  • full_path - Full path of the group including parent groups if any.
  • parent_id - ID of the parent group if the group is nested.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the group ID provided in the path parameters is correct and corresponds to a deleted group that can be restored.
  • If authentication is enabled, verify that the GitLab API key has sufficient permissions to restore groups.
  • Common error messages include 404 Not Found if the group ID does not exist or is not deleted, and 401 Unauthorized if authentication fails.

Links

Discussion