Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node allows an administrator to create a new organization within a Gitea instance via its API. It is useful for automating the management of organizations, especially in scenarios where multiple organizations need to be created programmatically or integrated into workflows. For example, a company onboarding process could automatically create an organization for each new department or team with predefined settings.

Properties

Name Meaning
Username The username of the user who will own the newly created organization (required).
Description A textual description of the organization.
Email Contact email address associated with the organization.
Full Name The full name of the organization.
Location Physical or geographical location of the organization.
Repo Admin Change Team Access Boolean flag indicating if repository admins can change team access (default: true).
Visibility Organization visibility level; options are public (default), limited, or private.
Website URL of the organization's website.

Output

The node outputs JSON data representing the newly created organization as returned by the Gitea API. This typically includes details such as the organization's ID, name, description, visibility, owner information, and other metadata. There is no binary output.

Dependencies

  • Requires connection to a Gitea instance with appropriate administrative API credentials.
  • The node expects an API key or token configured in n8n credentials to authenticate requests.
  • The base URL for the Gitea API must be set in the credentials configuration.

Troubleshooting

  • Authentication errors: Ensure that the API key/token has sufficient permissions to create organizations.
  • Validation errors: Required fields like "Username" must be provided; missing these will cause the request to fail.
  • API connectivity issues: Verify the Gitea instance URL and network accessibility.
  • Visibility option errors: Only public, limited, or private are accepted values; using others will result in errors.

Links and References

Discussion