GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves audit events for a specific project in GitLab using the GitLab API v4. 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 detailed project activity analysis.

Use Case Examples

  1. Fetch audit events created after a specific date to monitor recent changes.
  2. Retrieve audit events for a project with pagination to review all logged activities.

Properties

Name Meaning
Skip Authentication If set to true, the node skips authentication for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance to connect to, default is https://gitlab.com.
Method HTTP method to use for the API request, default is GET.
Query Parameters Optional query parameters to filter and paginate audit events.
Path Parameters Path parameters specifying the project ID to retrieve audit events for.

Output

JSON

  • id - The unique identifier of the audit event.
  • author_id - ID of the user who performed the action.
  • entity_id - ID of the entity affected by the audit event.
  • entity_type - Type of the entity affected.
  • details - Details about the audit event.
  • created_at - Timestamp when the audit event was created.
  • ip_address - IP address from which the action was performed.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the project ID is correctly provided in the path parameters; missing or incorrect ID will cause errors.
  • Verify that the authentication credentials are valid and have sufficient permissions to access project audit events.
  • Check the base URL if connecting to a self-hosted GitLab instance; incorrect URL will lead to connection failures.
  • Pagination parameters (page, per_page) should be valid integers; invalid values may cause unexpected results or errors.

Links

Discussion