Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node interacts with the Gitea API, specifically providing administrative capabilities. The "Admin List Hooks" operation allows users to retrieve a paginated list of webhook configurations set up in the Gitea instance. This is useful for administrators who want to audit, monitor, or manage webhooks that trigger on various repository or system events.

Practical examples include:

  • Fetching all configured webhooks to verify their targets and settings.
  • Monitoring webhook usage by listing them and checking their configuration.
  • Integrating with other systems by retrieving webhook data for synchronization or reporting.

Properties

Name Meaning
Page The page number of results to return (1-based). Use this to paginate through the hooks.
Limit The number of results per page (page size). Controls how many hooks are returned at once.

Output

The output contains a JSON array of webhook objects retrieved from the Gitea API. Each object represents a webhook with details such as its ID, URL, events it listens to, active status, and other metadata defined by Gitea's webhook structure.

No binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the Gitea instance.
  • The node expects the base URL of the Gitea server to be provided via credentials.
  • The node uses the Gitea REST API v1 endpoints under /api/v1.

Troubleshooting

  • Empty results: If no hooks are returned, verify that the page and limit parameters are set correctly and that webhooks exist in the Gitea instance.
  • Authentication errors: Ensure the API key credential is valid and has sufficient permissions to access admin endpoints.
  • API connectivity issues: Confirm the base URL is correct and the Gitea server is reachable.
  • Invalid parameter values: Page and limit should be positive integers; zero or negative values may cause unexpected behavior.

Links and References

Discussion