GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node interacts with the GitLab API to create new projects via the POST /api/v4/projects endpoint. It is useful for automating project creation in GitLab, such as setting up new repositories programmatically as part of a CI/CD pipeline or project management workflow.

Use Case Examples

  1. Automatically create a new GitLab project when a new client is onboarded.
  2. Integrate project creation into a DevOps pipeline to streamline repository setup.

Properties

Name Meaning
Skip Authentication Determines whether to skip API authentication for the request.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication. This property is hidden if Skip Authentication is true.
baseUrl The base URL of the GitLab instance to which the API request is sent. Defaults to https://gitlab.com.
Method The HTTP method to use for the request. Defaults to GET but for this operation POST is used.
Parameter Schema Defines the schema for the parameters expected in the request body for creating a project. This is a hidden property used internally.
Request Body Schema Defines the schema for the request body payload. This is a hidden property used internally.
Request Path The API endpoint path for creating projects, fixed to /api/v4/projects. This is a hidden property.

Output

JSON

  • id - The unique identifier of the created project.
  • name - The name of the created project.
  • description - The description of the created project.
  • web_url - The URL to access the project in GitLab.
  • created_at - The timestamp when the project was created.
  • default_branch - The default branch of the project repository.

Dependencies

  • GitLab API key credential for authentication
  • Base URL of the GitLab instance

Troubleshooting

  • Authentication errors if the API key is missing or invalid. Ensure the GitLab API key credential is correctly configured.
  • Permission errors if the API key does not have rights to create projects.
  • Invalid request body errors if required project parameters are missing or malformed.
  • Network errors if the base URL is incorrect or the GitLab instance is unreachable.

Links

Discussion