GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation retrieves a specific personal access token from the GitLab API using its ID. It is useful for scenarios where you need to fetch details about a particular personal access token for user authentication or management purposes. For example, an admin might use this to verify token details or audit token usage.

Use Case Examples

  1. Fetch details of a personal access token by providing its ID to manage user access.
  2. Retrieve token information to validate permissions or expiration.

Properties

Name Meaning
Skip Authentication If set to true, the node skips using authentication for the request.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent, defaulting to https://gitlab.com.
Method The HTTP method used for the request, defaulting to GET.
Path Parameters The path parameters for the API request, 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.
  • 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.
  • revoked - Indicates if the token has been revoked.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the provided personal access token ID is valid and exists; otherwise, the API will return an error.
  • Check that the authentication credentials are correctly configured unless 'Skip Authentication' is enabled.
  • Verify the base URL is correct for the GitLab instance being accessed.
  • Common error messages include 404 Not Found if the token ID does not exist, and 401 Unauthorized if authentication fails.

Links

Discussion