GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node interacts with the GitLab API, specifically supporting the creation of organizations via the POST method to the /api/v4/organizations endpoint. It is useful for automating the management of GitLab organizations within workflows, such as creating new organizations programmatically based on external triggers or data inputs.

Use Case Examples

  1. Automatically create a new GitLab organization when a new project is initiated in another system.
  2. Batch create multiple organizations in GitLab from a list of organization data.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance to which the API requests are sent.
Method The HTTP method to use for the API request, defaulting to GET but supporting POST, PUT, DELETE, HEAD, and PATCH.
Parameter Schema Defines the schema for the parameters expected in the request body for the postApiV4Organizations operation.
Request Body Schema Defines the schema for the request body for the postApiV4Organizations operation.
Request Path The API endpoint path for creating organizations, fixed to /api/v4/organizations.

Output

JSON

  • response - The JSON response from the GitLab API after creating an organization, containing details of the newly created organization.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the GitLab API authentication credential is correctly configured and has sufficient permissions to create organizations.
  • Verify the baseUrl is correct and accessible from the environment where the node runs.
  • Check that the request body matches the expected schema for creating organizations to avoid validation errors.
  • Common error messages may include authentication failures, permission denied, or invalid request body format. Resolving these typically involves verifying credentials, permissions, and request data format.

Links

Discussion