GiteaInstall

Overview

This node interacts with a Gitea server to retrieve detailed information about an annotated Git tag in a specific repository. It is useful when you need metadata about a particular tag, such as its message, tagger, and associated commit SHA. Typical use cases include automation workflows that require validation or processing of tagged releases or versions in a repository.

For example, you might use this node to fetch the annotation details of a release tag before deploying software or generating release notes.

Properties

Output

The node outputs JSON data representing the annotated tag object retrieved from the Gitea API. This typically includes fields such as:

• Tag message
• Tagger information (name, email, date)
• Object the tag points to (commit SHA and type)
• Tag name and SHA

No binary data output is produced by this node.

Dependencies

• Requires connection to a Gitea instance via its REST API.
• 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.

Troubleshooting

• Common issues:

  • Providing a SHA that corresponds to a lightweight tag will fail because the API only supports annotated tags.
  • Incorrect owner or repo names will result in "not found" errors.
  • Missing or invalid API credentials will cause authentication failures.

• Error messages:

  • 404 Not Found: Check if the owner, repo, and SHA values are correct and that the tag exists.
  • 401 Unauthorized: Verify that the API key credential is valid and has sufficient permissions.
  • 400 Bad Request: Ensure the SHA provided is for an annotated tag, not a lightweight tag.

Links and References

• Gitea API Documentation - Git Tags
• Gitea Official Website