GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation retrieves SSH keys from the GitLab API (version 4) using a specified fingerprint as a query parameter. It is useful for scenarios where you need to fetch details about a specific SSH key associated with a GitLab user or project by providing its fingerprint. For example, it can be used to verify or manage SSH keys programmatically within automation workflows.

Use Case Examples

  1. Fetch SSH key details by fingerprint to verify access permissions.
  2. Automate SSH key management by retrieving key information for auditing.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public or unauthenticated endpoints.
Authentication Type of authentication used for the request, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent, defaulting to https://gitlab.com.
Method HTTP method used for the API request, defaulting to GET. Options include GET, POST, PUT, DELETE, HEAD, PATCH.
Query Parameters Collection of query parameters for the API request, specifically including the fingerprint of the SSH key to retrieve.

Output

JSON

  • id - The unique identifier of the SSH key.
  • title - The title or name of the SSH key.
  • key - The actual SSH public key string.
  • created_at - Timestamp when the SSH key was created.
  • expires_at - Timestamp when the SSH key expires, if applicable.
  • user_id - The ID of the user who owns the SSH key.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the fingerprint query parameter is provided and correctly formatted; missing or invalid fingerprints will cause the API request to fail.
  • If authentication is required and skipped, the request may be unauthorized or rejected by the GitLab API.
  • Verify the baseUrl is correct and accessible; incorrect URLs will result in connection errors.
  • Common error messages include 401 Unauthorized (check API key and authentication settings) and 404 Not Found (check the fingerprint value).

Links

Discussion