GitLab API icon

GitLab API

Gitlab

Actions1062

Groups → getApiV4GroupsIdAuditEvents

AI-generated

Summary

Retrieve a paginated list of audit events for a specified group by its ID from the GitLab API.

Inputs

  • id (required) — The unique integer ID of the GitLab group for which to fetch audit events.
  • created_after — Filter to return audit events created after this ISO 8601 date-time string.
  • created_before — Filter to return audit events created before this ISO 8601 date-time string.
  • page — The page number to retrieve for paginated results, defaulting to 1.
  • per_page — The number of audit event items to return per page, defaulting to 20.

Output shape

a paginated list of audit event objects associated with the specified group ID

Supports pagination via 'page' and 'per_page' query parameters. Filtering by event creation date is possible using 'created_after' and 'created_before' ISO 8601 timestamps. Requires authentication unless 'Skip Authentication' is enabled. Returned data structure follows GitLab API v4 conventions for audit events.

Examples

Example 1: Retrieve the first page of audit events for group ID 123 with default page size

Set 'id' path parameter to '123', leave query parameters empty.

Example 2: Filter audit events created after January 1, 2023, for group ID 123

Set 'id' to '123', set 'created_after' query parameter to '2023-01-01T00:00:00Z'.

Links

Discussion