GitLab API icon

GitLab API

Gitlab

Actions880

Overview

This node operation retrieves audit events for a specific project in GitLab using the GitLab API. It is useful for monitoring and auditing changes or activities within a project, such as tracking user actions or security-related events. For example, a user can fetch audit logs created within a certain date range or paginate through audit events for compliance or security reviews.

Use Case Examples

  1. Fetch audit events for a project with ID 123, filtering events created after 2023-01-01.
  2. Retrieve the first page of audit events with 50 events per page for project ID 456.

Properties

Name Meaning
Skip Authentication If set to true, the node will skip using authentication for the API request.
baseUrl The base URL of the GitLab instance to send requests to, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Query Parameters Optional query parameters to filter and paginate audit events, including created_after, created_before, page, and per_page.
Path Parameters Path parameter specifying the project ID for which to retrieve audit events.

Output

JSON

  • audit_events - List of audit events retrieved for the specified project.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the project ID path parameter is provided and valid; missing or invalid ID will cause request failure.
  • Verify authentication credentials are correctly configured unless Skip Authentication is enabled.
  • Check that the baseUrl is correct and accessible, especially if using a self-hosted GitLab instance.
  • If filtering by date, ensure date strings are in ISO 8601 format (e.g., 2016-01-19T09:05:50.355Z).

Links

Discussion