GitLab API icon

GitLab API

Gitlab

Actions880

Overview

This node operation allows users to add SSH certificates to a specific GitLab group by making a POST request to the GitLab API endpoint `/api/v4/groups/{id}/ssh_certificates`. It is useful for automating the management of SSH certificates within GitLab groups, such as adding new certificates for group members or automation purposes.

Use Case Examples

  1. Automatically add SSH certificates to a GitLab group when onboarding new team members.
  2. Integrate with CI/CD pipelines to manage SSH certificates for GitLab groups programmatically.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or public endpoints.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET but POST is used for this operation.
Path Parameters Parameters to be included in the request path, specifically the group ID for this operation.

Output

JSON

  • id - The unique identifier of the SSH certificate added to the group.
  • name - The name of the SSH certificate.
  • fingerprint - The fingerprint of the SSH certificate.
  • created_at - Timestamp when the SSH certificate was created.
  • expires_at - Expiration date of the SSH certificate, if any.

Dependencies

  • GitLab API authentication credentials

Troubleshooting

  • Ensure the group ID provided in the path parameters is valid and the authenticated user has permission to add SSH certificates to the group.
  • Verify that the base URL is correct and accessible.
  • If skipping authentication, ensure the endpoint allows unauthenticated requests, otherwise authentication errors will occur.
  • Common error messages include 401 Unauthorized (authentication issues), 404 Not Found (invalid group ID), and 400 Bad Request (invalid request body). Verify request parameters and authentication to resolve these.

Links

Discussion