Forgejo icon

Forgejo

Interact with Forgejo API
Join our community

Actions73

Overview

This node operation creates a new tag in a specified repository on Forgejo. It is useful for developers and DevOps teams who want to programmatically manage tags in their repositories, such as marking release points or important commits. For example, it can be used to automate tagging a commit with a version number after a successful build.

Use Case Examples

  1. Create a tag named 'v1.0.0' with a message 'Initial release' targeting the default branch commit SHA in a repository owned by 'username'.
  2. Create a tag named 'hotfix' without a message targeting a specific commit SHA in a repository.

Properties

Name Meaning
Owner The username or organization that owns the repository where the tag will be created.
Repository The name of the repository where the tag will be created.
Tag Name The name of the tag to create.
Message An optional message describing the tag.
Target The commit SHA that the tag points to. Defaults to the repository's default branch if not specified.

Output

JSON

  • json
    • tag_name - The name of the created tag.
    • message - The message associated with the tag.
    • target - The commit SHA the tag points to.
    • * - Other properties returned by the Forgejo API for the created tag.

Dependencies

  • Requires an API key credential for Forgejo API authentication.

Troubleshooting

  • Ensure the 'owner' and 'repository' parameters are correctly set to existing repository details to avoid 404 errors.
  • Verify that the API key credential has sufficient permissions to create tags in the repository.
  • If the 'target' commit SHA is invalid or does not exist, the API will return an error; ensure the commit SHA is correct or omit it to default to the repository's default branch.
  • Network or authentication errors may occur if the Forgejo server URL or API key is misconfigured.

Links

Discussion