GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation fetches a list of topics from the GitLab API (version 4). It allows users to retrieve topics based on various query parameters such as search criteria, whether topics have assigned projects, organization ID, pagination page number, and items per page. This is useful for scenarios where users want to filter and browse GitLab topics programmatically, for example, to display relevant topics in a dashboard or to analyze topic distribution across projects.

Use Case Examples

  1. Retrieve topics matching a search term to display in a UI.
  2. Fetch topics without assigned projects for cleanup or analysis.
  3. Paginate through topics to process or export them in batches.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the request (boolean). Defaults to false.
Authentication The authentication method used for the request, hidden unless skipping authentication is false. Defaults to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to send the request to. Defaults to https://gitlab.com.
Method The HTTP method to use for the request. Defaults to GET.
Query Parameters Collection of optional query parameters to filter and paginate the topics list.

Output

JSON

  • id - Unique identifier of the topic.
  • name - Name of the topic.
  • project_count - Number of projects associated with the topic.
  • created_at - Timestamp when the topic was created.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the baseUrl is correct and accessible.
  • Verify that the GitLab API key credential is valid and has sufficient permissions.
  • Check that query parameters are correctly formatted, especially boolean and integer values as strings.
  • Common error messages include authentication failures (401 Unauthorized) and invalid query parameters (400 Bad Request). Resolving these involves correcting credentials and parameter formats.

Links

Discussion