GitLab API

GitlabTool

Actions1095

Projects → getApiV4ProjectsIdHooksHookIdEvents

AI-generated

Summary

Retrieve hook event details for a specific project hook in GitLab by sending a GET request to the endpoint /api/v4/projects/{id}/hooks/{hook_id}/events, optionally filtering by status and paginating results.

Inputs

  • id (required) — The ID of the GitLab project to query.
  • hook_id (required) — The ID of the hook within the specified project.
  • status — Optional filter to select events by their HTTP status codes or status categories (e.g., 'successful', 'client_failure'). Can be multiple values.
  • per_page — Optional number of items to return per page (defaults to 20, maximum 20).
  • page — Optional page number to retrieve (defaults to 1).

Output shape

a list of hook event records matching the project and hook IDs, optionally filtered and paginated

Output is paginated according to per_page and page query parameters. The response includes event information related to the specified webhook. Authentication is required unless 'Skip Authentication' is enabled.

Links

Discussion