Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node operation retrieves a paginated list of teams within a specified organization from a Gitea instance. It is useful when you want to programmatically access and manage the teams associated with an organization, for example, to audit team memberships, synchronize team data with other systems, or display organizational structure in custom dashboards.

Practical examples:

  • Fetching all teams in an organization to generate reports on team activity.
  • Integrating team information into an internal tool for managing permissions.
  • Automating synchronization of team data between Gitea and another service.

Properties

Name Meaning
Org The name of the organization whose teams you want to list.
Page The page number of results to return (1-based). Useful for paginating through large sets.
Limit The maximum number of results to return per page (page size).

Output

The node outputs JSON data representing the list of teams retrieved from the specified organization. Each item in the output array corresponds to a team object as returned by the Gitea API, typically including details such as team ID, name, description, permission level, and members count.

No binary data output is involved in this operation.

Dependencies

  • Requires connection to a Gitea instance via its REST API.
  • Needs an API authentication token configured in the node credentials to authorize requests.
  • The base URL for the Gitea API must be set in the credentials configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing organization name will result in errors or empty responses.
    • Incorrect API credentials or insufficient permissions can cause authorization failures.
    • Pagination parameters (page and limit) set incorrectly may lead to unexpected or empty results.
  • Error messages:

    • Authorization errors typically indicate invalid or expired API tokens; reconfigure credentials.
    • "Organization not found" errors suggest the provided organization name does not exist or is misspelled.
    • Rate limiting errors from the API require waiting or adjusting request frequency.

Links and References

Discussion