GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation allows users to create a new badge for a specific group in GitLab by making a POST request to the GitLab API endpoint `/api/v4/groups/{id}/badges`. It is useful for automating badge management within GitLab groups, such as adding status or achievement badges programmatically.

Use Case Examples

  1. Automatically add a badge to a GitLab group when a new project milestone is reached.
  2. Create custom badges for groups based on external CI/CD pipeline results.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public or unauthenticated API calls.
Authentication Select the authentication method to use, typically an API key credential for GitLab.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is POST for this operation.
Path Parameters Parameters to be included in the request path, specifically the group ID or URL-encoded path to identify the group for which the badge is created.

Output

JSON

  • id - The unique identifier of the created badge.
  • name - The name of the badge.
  • image_url - URL to the badge image.
  • link_url - URL the badge links to.
  • group_id - The ID of the group to which the badge belongs.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the group ID provided in the path parameters is correct and accessible by the authenticated user.
  • Verify that the authentication credentials are valid and have the necessary permissions to create badges in the specified group.
  • Check the request body schema to ensure all required fields for badge creation are included and correctly formatted.

Links

Discussion