GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves details about a specific integration service for a given project in GitLab. It is useful for scenarios where you need to programmatically access configuration or status information of integrations like Slack, Jira, or Jenkins linked to a GitLab project. For example, a user might use this node to check if the Slack integration is enabled for a project or to fetch its settings.

Use Case Examples

  1. Fetch the Slack integration details for a project with ID 12345.
  2. Retrieve the configuration of the Jira integration for a specific GitLab project.

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. Hidden if Skip Authentication is true.
baseUrl The base URL of the GitLab instance to send the request to, defaulting to https://gitlab.com.
Method The HTTP method to use for the request, defaulting to GET.
Slug The name of the integration service to retrieve, e.g., slack, jira, or github.
Id The ID of the GitLab project for which the integration service details are requested.

Output

JSON

  • id - The unique identifier of the integration service.
  • title - The display name of the integration service.
  • active - Indicates whether the integration service is active for the project.
  • properties - Additional configuration details and settings of the integration service.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the project ID and integration slug are correct and exist in the GitLab instance.
  • Verify that the authentication credentials are valid and have sufficient permissions to access project integrations.
  • Check the baseUrl if using a self-hosted GitLab instance to ensure it is correct.
  • Common error messages include 404 Not Found if the project or integration does not exist, and 401 Unauthorized if authentication fails.

Links

Discussion