Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node operation allows searching for teams within a specified organization in Gitea, a self-hosted Git service. It is useful when you want to find teams by keywords, optionally including their descriptions, and paginate through the results. Typical use cases include automating team management workflows, auditing team memberships, or integrating team data into other systems.

For example, you might search for all teams related to "frontend" in your organization to gather their details or synchronize them with another tool.

Properties

Name Meaning
Org The name of the organization where the team search will be performed (required).
Q Keywords to search for in team names (and optionally descriptions).
Include Desc Whether to include the team description field in the search (defaults to true).
Page The page number of results to return, starting at 1 (0 means default or first page).
Limit The number of results per page (page size).

Output

The node outputs JSON data representing the list of teams matching the search criteria within the specified organization. Each item in the output typically contains team details such as team ID, name, description, permission levels, and other metadata as provided by the Gitea API.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to a Gitea instance via its 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 results.
    • Incorrect API credentials or insufficient permissions may cause authorization failures.
    • Pagination parameters (page and limit) set to zero or negative values might lead to unexpected results or defaults.
  • Error messages:
    • Authorization errors indicate problems with the API key/token; verify credentials.
    • "Organization not found" errors suggest the org name is incorrect or inaccessible.
    • Network or timeout errors require checking connectivity to the Gitea server.

Links and References

Discussion