Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node integrates with the Gitea API to manage organization teams. Specifically, the "Org Add Team Member" operation allows users to add a member to a specified team within an organization. This is useful for automating team management tasks such as onboarding new members or adjusting team compositions programmatically.

Practical examples include:

  • Automatically adding a user to a development team when they join a project.
  • Managing access control by updating team memberships based on external HR systems.
  • Synchronizing team members across multiple repositories or organizations.

Properties

Name Meaning
Id The numeric identifier of the team to which the user will be added.
Username The username of the user to add to the team.

Output

The node outputs JSON data representing the result of the API call to add a team member. This typically includes confirmation details such as the updated team membership or status messages from the Gitea API. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the Gitea instance.
  • Needs the base URL of the Gitea server configured in the credentials.
  • Depends on the Gitea REST API endpoint /api/v1 for operations.

Troubleshooting

  • Common issues:
    • Invalid team ID or username may cause the API to reject the request.
    • Insufficient permissions for the API key can lead to authorization errors.
    • Network connectivity problems with the Gitea server.
  • Error messages:
    • Authorization errors usually indicate missing or incorrect API credentials.
    • "Team not found" or similar errors suggest the provided team ID does not exist.
    • "User not found" indicates the username is invalid or does not exist in the organization.
  • Resolutions:
    • Verify the correctness of the team ID and username inputs.
    • Ensure the API key has sufficient permissions to modify team memberships.
    • Check network connectivity and the Gitea server URL configuration.

Links and References

Discussion