Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node interacts with the Gitea API to list labels associated with a specific organization. It is useful when you want to retrieve and manage labels used within an organization's repositories or projects in Gitea. For example, you might use this node to fetch all labels for an organization to display them in a dashboard or to automate label-based workflows.

Properties

Name Meaning
Org The name of the organization whose labels you want to list.
Page The page number of results to return (1-based). Useful for paginating through many labels.
Limit The number of results to return per page (page size). Controls how many labels are fetched at once.

Output

The node outputs JSON data containing the list of labels retrieved from the specified organization. Each label typically includes properties such as its name, color, and description (depending on the Gitea API response structure). This output can be used downstream in workflows for further processing or display.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authenticating with the Gitea instance.
  • The node expects the base URL of the Gitea server to be configured in the credentials.
  • Uses the Gitea REST API v1 endpoint /api/v1.

Troubleshooting

  • Invalid Organization Name: If the organization name is incorrect or does not exist, the API will likely return an error or empty result. Verify the organization name spelling.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Ensure the API key/token is valid and has sufficient permissions.
  • Pagination Issues: Setting Page or Limit incorrectly (e.g., zero or negative values) may lead to unexpected results or errors. Use positive integers starting from 1 for pages.
  • API Rate Limits: If the Gitea server enforces rate limits, frequent requests may be throttled. Implement retry logic or reduce request frequency if needed.

Links and References

Discussion