GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation unarchives a specific project in GitLab by sending a POST request to the GitLab API endpoint `/api/v4/projects/{id}/unarchive`. It is useful for restoring projects that were previously archived, making them active and accessible again. A practical example is when a user wants to reactivate a project that was archived for inactivity or completion.

Use Case Examples

  1. Unarchive a project by providing its ID or URL-encoded path to restore it for active development or collaboration.
  2. Use this operation in automation workflows to manage project lifecycle states in GitLab.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or public endpoints.
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 HTTP method to use for the request, defaulting to GET but typically POST for this operation.
Path Parameters Parameters to be included in the request path, specifically the project ID or URL-encoded path to identify the project to unarchive.

Output

JSON

  • id - The unique identifier of the unarchived project.
  • name - The name of the unarchived project.
  • path - The URL-encoded path of the unarchived project.
  • archived - Boolean indicating whether the project is archived (should be false after unarchiving).
  • visibility - The visibility level of the project (e.g., private, internal, public).
  • created_at - Timestamp when the project was created.
  • last_activity_at - Timestamp of the last activity in the project.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the project ID or URL-encoded path is correctly provided in the path parameters; otherwise, the API will return an error indicating the project was not found.
  • Authentication errors may occur if the GitLab API key is missing, invalid, or lacks sufficient permissions to unarchive projects. Verify the API key and its scopes.
  • HTTP method should be POST for this operation; using other methods may result in unexpected errors.
  • Check the baseUrl if using a self-hosted GitLab instance to ensure the request targets the correct server.

Links

Discussion