GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves a specific personal access token from GitLab using its ID. It is useful for scenarios where you need to fetch details about a particular personal access token for user management, auditing, or integration purposes. For example, you might use this node to verify token details before performing actions on behalf of a user.

Use Case Examples

  1. Fetch details of a personal access token by providing its ID to manage user permissions or audit token usage.
  2. Retrieve token information to validate access rights in an automated workflow.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or when authentication is handled externally.
Authentication Selects the authentication method, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the request is sent, defaulting to https://gitlab.com.
Method HTTP method used for the request, defaulting to GET.
Path Parameters Parameters included in the request path, specifically the ID of the personal access token to retrieve.

Output

JSON

  • id - The unique identifier of the personal access token.
  • name - The name of the personal access token.
  • revoked - Indicates if the token has been revoked.
  • scopes - The scopes or permissions granted by the token.
  • created_at - The creation timestamp of the token.
  • expires_at - The expiration date of the token.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the provided personal access token ID is valid and exists in the GitLab instance.
  • Verify that the GitLab API key credential has sufficient permissions to access personal access tokens.
  • Check the baseUrl to ensure it points to the correct GitLab instance.
  • Common error messages include 404 Not Found if the token ID does not exist, and 401 Unauthorized if authentication fails.

Links

Discussion