GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation allows updating a GitLab project by sending a PUT request to the GitLab API endpoint `/api/v4/projects/{id}`. It is useful for modifying project details such as name, description, visibility, and other project settings by specifying the project ID or URL-encoded path.

Use Case Examples

  1. Updating a project's description and visibility by providing the project ID and the new values in the request body.
  2. Changing the project name or other attributes using the GitLab API through this node.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the request. If true, authentication is bypassed.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication. Hidden if Skip Authentication is true.
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 set to PUT for this operation.
Path Parameters Collection of path parameters required for the request, specifically the project ID or URL-encoded path to identify the project to update.

Output

JSON

  • id - The unique identifier of the updated project.
  • name - The name of the updated project.
  • description - The description of the updated project.
  • visibility - The visibility level of the updated project (e.g., private, internal, public).
  • web_url - The web URL to access the updated project.
  • created_at - The timestamp when the project was created.
  • last_activity_at - The timestamp of the last activity in the project.

Dependencies

  • GitLab API authentication 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.
  • If authentication is skipped, the request may fail due to lack of proper authorization; verify credentials if authentication is enabled.
  • Check that the base URL is correct and accessible, especially if using a self-hosted GitLab instance.
  • Common error messages include 404 Not Found (invalid project ID), 401 Unauthorized (authentication issues), and 400 Bad Request (invalid request body). Verify the request parameters and authentication settings to resolve these.

Links

  • GitLab API - Edit Project - Official GitLab API documentation for updating project details via the PUT /projects/:id endpoint.

Discussion