GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation checks the existence of a specific namespace in GitLab by its ID. It is useful for workflows that need to verify whether a namespace exists before proceeding with further actions, such as creating projects or managing permissions within that namespace. For example, it can be used to validate user input or automate namespace management tasks.

Use Case Examples

  1. Check if a namespace with a given ID exists before creating a project under it.
  2. Validate namespace existence in a CI/CD pipeline to ensure correct resource targeting.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the request.
Authentication The authentication method used for the request, typically an API key credential.
baseUrl The base URL of the GitLab instance to send the request to.
Method The HTTP method used for the request, default is GET.
Query Parameters Optional query parameters for the request, including parent_id to filter namespaces by parent.
Path Parameters Path parameters for the request, specifically the namespace ID to check existence for.

Output

JSON

  • exists - Boolean indicating whether the namespace with the specified ID exists.

Dependencies

  • GitLab API authentication token or API key credential

Troubleshooting

  • Ensure the namespace ID path parameter is correctly provided; missing or incorrect ID will cause errors.
  • If authentication is enabled, verify that the API key or token is valid and has sufficient permissions.
  • Check the baseUrl to ensure it points to the correct GitLab instance, especially if using a self-hosted GitLab server.

Links

Discussion