GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node interacts with the GitLab API to create a new group using the POST method on the /api/v4/groups endpoint. It is useful for automating group management in GitLab, such as creating project groups programmatically within CI/CD pipelines or administrative workflows.

Use Case Examples

  1. Creating a new GitLab group with specific settings via an automated workflow.
  2. Integrating GitLab group creation into a larger DevOps automation process.

Properties

Name Meaning
Skip Authentication Determines whether to skip the authentication step for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request, default is GET but POST is used for creating groups.

Output

JSON

  • id - The unique identifier of the created GitLab group.
  • name - The name of the created GitLab group.
  • path - The URL path of the created GitLab group.
  • description - The description of the created GitLab group.
  • visibility - The visibility level of the created GitLab group (e.g., private, internal, public).
  • web_url - The web URL to access the created GitLab group.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the GitLab API key credential is correctly configured and has permissions to create groups.
  • Verify the baseUrl is correct and accessible.
  • Check that the request body schema matches the expected format for creating a group in GitLab.
  • Common errors include authentication failures, invalid request body, or insufficient permissions.

Links

Discussion