GitLab API icon

GitLab API

Gitlab

Actions880

Overview

This node operation allows users to create a new group in GitLab by making a POST request to the GitLab API endpoint `/api/v4/groups`. It is useful for automating group management within GitLab, such as setting up new project groups programmatically.

Use Case Examples

  1. Creating a new GitLab group with specific settings via an automated workflow.
  2. Integrating GitLab group creation into a CI/CD pipeline or project setup process.

Properties

Name Meaning
Skip Authentication Determines whether to skip the authentication step for the API request.
Authentication Specifies the authentication method to use for the API request, typically an API key credential.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request, defaulting to POST for this operation.

Output

JSON

  • id - The unique identifier of the created GitLab group.
  • name - The name of the created GitLab group.
  • path - The path or URL slug 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 authentication credential

Troubleshooting

  • Ensure the API authentication token is valid and has sufficient permissions to create groups.
  • Verify the base URL is correct and accessible.
  • Check that the request body conforms to the required schema for creating a group.
  • Common error messages include authentication failures, permission denied, and invalid request body format. Resolving these typically involves updating credentials, adjusting permissions, or correcting the request payload.

Links

Discussion