Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

The node provides an operation to search for users within the Admin resource of a Gitea instance via its API. It allows filtering users based on login source ID and login name, with support for pagination through page number and limit parameters. This is useful in administrative scenarios where you need to programmatically query user accounts, for example, to audit users, synchronize user data, or manage user access.

Properties

Name Meaning
Source Id ID of the user's login source to filter the search by (numeric).
Login Name The login name of the user to search for (string).
Page The page number of results to return, starting at 1 (numeric).
Limit The number of results per page to return (numeric).

Output

The output contains a JSON array of user objects matching the search criteria. Each user object includes details as returned by the Gitea API's admin user search endpoint. The exact structure depends on the API response but typically includes user identifiers, login names, email addresses, and other user metadata.

No binary data output is indicated.

Dependencies

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

Troubleshooting

  • Empty Results: If no users are returned, verify that the source_id and login_name filters are correct and that the page and limit values are set appropriately.
  • Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to perform admin user searches.
  • Pagination Issues: If too many or too few results are returned, check the page and limit parameters for correctness; note that page numbering starts at 1.
  • API Connectivity: Confirm the Gitea base URL is reachable and correctly configured in the credentials.

Links and References

Discussion