GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation retrieves access tokens for a specific group in GitLab using the GitLab API v4. It is useful for scenarios where you need to manage or audit group access tokens, such as checking which tokens are active or inactive for security or administrative purposes. For example, an admin can use this node to list all active access tokens for a group to ensure only authorized tokens are in use.

Use Case Examples

  1. Retrieve all active access tokens for a GitLab group by specifying the group ID and filtering by 'active' state.
  2. Audit inactive access tokens for a group to identify tokens that may need to be revoked or cleaned up.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or public endpoints.
Authentication Type of authentication used, default is GitLab API key authentication.
baseUrl Base URL of the GitLab instance, default is https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Query Parameters Optional query parameters to filter the request, such as filtering tokens by their state (active or inactive).
Path Parameters Path parameters required for the request, specifically the group ID or URL-encoded path of the group.

Output

JSON

  • tokens - List of access tokens for the specified GitLab group, including details such as token state and permissions.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the group ID provided in the path parameters is correct and accessible with the authenticated user.
  • Verify that the API key used has sufficient permissions to read group access tokens.
  • If filtering by state, ensure the value is either 'active' or 'inactive' to avoid invalid query errors.
  • Check the base URL if using a self-hosted GitLab instance to ensure the API endpoint is reachable.

Links

Discussion