Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node operation allows you to create a new label within a specified organization. Labels are typically used to categorize or tag issues, pull requests, or other organizational items in project management and version control systems. This operation is beneficial when you want to automate the labeling process for better organization and filtering of tasks or resources.

Practical examples include:

  • Automatically creating standardized labels for new projects or teams.
  • Adding color-coded tags to issues based on priority or type.
  • Archiving or marking labels as exclusive to control their usage scope.

Properties

Name Meaning
Org The name of the organization where the label will be created.
Color The color code (e.g., hex format) representing the label's color.
Description A textual description providing more details about the label.
Exclusive A boolean indicating if the label is exclusive (true) or not (false).
Is Archived A boolean indicating whether the label is archived (true) or active (false).
Name The name of the label to be created.

Output

The output JSON contains the details of the newly created label within the organization. This includes all properties sent during creation such as the label's name, color, description, exclusivity status, and archival state. The output can be used downstream to confirm label creation or to reference the label in subsequent workflow steps.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Gitea API.
  • The node must be configured with the base URL of the Gitea instance.
  • Network access to the Gitea API endpoint is necessary.

Troubleshooting

  • Common Issues:
    • Invalid or missing organization name may cause the API to reject the request.
    • Incorrect color format might lead to label creation failure.
    • Lack of proper permissions or invalid API credentials will result in authentication errors.
  • Error Messages:
    • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly set and has sufficient permissions.
    • "Organization not found": Verify the organization name is correct and exists in the Gitea instance.
    • "Invalid input": Ensure all required fields (Org, Name, Color) are provided and valid.

Links and References

Discussion