GitLab API

GitlabTool
Join our community

Actions905

Overview

This node interacts with the GitLab API to retrieve personal access token associations for the authenticated user. It is useful for scenarios where you need to manage or audit personal access tokens linked to your GitLab account, such as checking token permissions or usage. For example, it can be used to fetch tokens with a minimum access level or paginate through token associations.

Use Case Examples

  1. Fetch all personal access token associations for the authenticated user.
  2. Retrieve token associations with a minimum access level of 30.
  3. Paginate through token associations by specifying page number and items per page.

Properties

Name Meaning
Skip Authentication If set to true, the node will skip using authentication credentials 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 requests are sent, defaulting to https://gitlab.com.
Method The HTTP method used for the API request, defaulting to GET.
Query Parameters Optional query parameters to filter or paginate the results.

Output

JSON

  • id - The unique identifier of the personal access token association.
  • name - The name of the personal access token.
  • scopes - The scopes or permissions granted to the token.
  • created_at - The creation timestamp of the token.
  • expires_at - The expiration date of the token, if any.
  • access_level - The access level associated with the token.

Dependencies

  • GitLab API credentials for authentication

Troubleshooting

  • Ensure the GitLab API credentials are correctly configured and have sufficient permissions to access personal access tokens.
  • Verify the baseUrl is correct and accessible, especially if using a self-hosted GitLab instance.
  • Check query parameter values for correctness, such as valid integers for page and per_page.
  • Common error messages may include authentication failures or permission denied errors, which can be resolved by updating credentials or permissions.

Links

Discussion