GitLab API

GitlabTool

Actions1000

Overview

This node operation retrieves deploy tokens from the GitLab API (version 4). It is useful for scenarios where users need to list or filter deploy tokens associated with their GitLab projects or groups, such as for automation or auditing purposes. For example, a user can fetch active deploy tokens with pagination support to manage access credentials programmatically.

Use Case Examples

  1. Fetch the first page of active deploy tokens with 20 items per page.
  2. Retrieve deploy tokens without authentication for public repositories if skipAuthentication is enabled.

Properties

Name Meaning
Skip Authentication Determines whether to skip API authentication for the request.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication. Hidden if Skip Authentication is true.
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 Optional query parameters to filter and paginate the deploy tokens list.

Output

JSON

  • deploy_tokens - Array of deploy token objects returned from the GitLab API.
  • pagination
    • page - Current page number of the results.
    • per_page - Number of items per page in the results.
    • total - Total number of deploy tokens available.

Dependencies

  • GitLab API credentials for authentication

Troubleshooting

  • Ensure the GitLab API credentials are correctly configured and have sufficient permissions to access deploy tokens.
  • If skipAuthentication is set to true, the API request may fail or return limited data depending on the GitLab instance's public access settings.
  • Verify that the baseUrl is correct and reachable to avoid connection errors.
  • Check that query parameters like page and per_page are valid integers to prevent request errors.

Links

Discussion