GitLab API

GitlabTool

Actions1000

Overview

This node operation allows creating a new wiki page in a specified GitLab project by sending a POST request to the GitLab API endpoint `/api/v4/projects/{id}/wikis`. It is useful for automating documentation updates or managing project wikis programmatically within GitLab.

Use Case Examples

  1. Automatically add or update project documentation by creating wiki pages via this node.
  2. Integrate wiki page creation into CI/CD pipelines to keep project documentation synchronized with code changes.

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 authentication.
baseUrl Base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET but POST is used for this operation.
Path Parameters Parameters to be included in the request path, specifically the project ID for this operation.

Output

JSON

  • id - ID of the created wiki page
  • title - Title of the created wiki page
  • content - Content of the created wiki page
  • format - Format of the wiki page content
  • slug - Slug (URL-friendly identifier) of the wiki page
  • created_at - Timestamp when the wiki page was created
  • updated_at - Timestamp when the wiki page was last updated
  • url - URL to access the created wiki page

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID path parameter is correctly set and corresponds to an existing GitLab project.
  • Verify that the authentication credentials are valid and have sufficient permissions to create wiki pages in the project.
  • Check the base URL if using a self-hosted GitLab instance to ensure it is correct.
  • Common error messages include 401 Unauthorized (authentication failure), 404 Not Found (invalid project ID), and 400 Bad Request (invalid request body). Resolving these involves correcting credentials, project ID, or request payload respectively.

Links

Discussion