GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation allows creating a new organization in GitLab via the GitLab API. It is useful for automating the management of organizations within GitLab, such as setting up new teams or groups programmatically. For example, a user can automate the creation of multiple organizations as part of a deployment or onboarding process.

Use Case Examples

  1. Automate creation of a new organization in GitLab when a new project is initiated.
  2. Create organizations in bulk based on external data sources for team management.

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 to which the API request is sent.
Method HTTP method used for the API request, defaulting to GET but can be set to POST, PUT, DELETE, HEAD, or PATCH.
Parameter Schema Schema defining the parameters for the POST /api/v4/organizations operation, required in the request body.
Request Body Schema Schema for the request body to be sent when creating an organization, defining the structure and required fields.
Request Path API endpoint path for creating organizations, fixed to /api/v4/organizations.

Output

JSON

  • id - Unique identifier of the created organization.
  • name - Name of the created organization.
  • description - Description of the organization.
  • created_at - Timestamp when the organization was created.
  • updated_at - Timestamp when the organization was last updated.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the GitLab API key credential is correctly configured and has permissions to create organizations.
  • Verify the baseUrl is correct and accessible.
  • Check that the request body matches the required schema for creating an organization.
  • Common error messages include authentication failures, invalid request body, or insufficient permissions. Verify API key and request data accordingly.

Links

Discussion