Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node operation allows you to list packages owned by a specified user or organization in a Gitea instance. It is useful for retrieving package metadata filtered by type, name, and pagination options. Typical use cases include automating package inventory management, auditing available packages, or integrating package data into workflows for deployment or analysis.

For example, you might use this node to:

  • Retrieve all npm packages owned by a specific user.
  • List container images published under an organization.
  • Paginate through Python (PyPI) packages to gather version information.

Properties

Name Meaning
Owner The owner (user or organization) of the packages to list.
Page The page number of results to return (1-based). Used for paginating through results.
Limit The number of results per page (page size).
Type Filter packages by type. Options include: Alpine, Cargo, Chef, Composer, Conan, Conda, Container, Cran, Debian, Generic, Go, Helm, Maven, Npm, Nuget, Pub, Pypi, Rpm, Rubygems, Swift, Vagrant.
Q A search string to filter packages by name.

Output

The output JSON contains a list of package objects matching the specified filters. Each package object typically includes metadata such as package name, version, type, and other relevant details provided by the Gitea API.

If the node supports binary data output (not indicated here), it would represent package files or related binary content.

Dependencies

  • Requires access to a Gitea instance with API enabled.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The base URL for the Gitea API must be set in the credentials configuration.

Troubleshooting

  • Missing or invalid owner: Ensure the "Owner" property is correctly set; otherwise, the API will not return results.
  • Pagination issues: If no results appear, verify that the "Page" and "Limit" values are within valid ranges.
  • Authentication errors: Confirm that the API key credential is valid and has sufficient permissions to access package data.
  • Invalid package type: Use one of the predefined package types listed in the "Type" property options.
  • Network or API errors: Check connectivity to the Gitea server and ensure the API endpoint is reachable.

Links and References

Discussion