Gitea icon

Gitea

Interact with Gitea via API
Join our community

Actions393

Overview

This node allows you to edit the settings of a repository in Gitea, a self-hosted Git service. It is useful for automating repository configuration changes such as enabling or disabling features (issues, wiki, pull requests), setting merge strategies, updating descriptions, and managing repository visibility and defaults.

Common scenarios include:

  • Automating repository setup after creation.
  • Enforcing organizational policies on repository settings.
  • Updating repository metadata or feature toggles in bulk.
  • Managing repository archival status or default branches programmatically.

For example, you could use this node to disable issues and wiki on a repository, set the default branch to "main", and enable squash merging for pull requests automatically.

Properties

Name Meaning
Owner Owner of the repository to edit.
Repo Name of the repository to edit.
Allow Fast Forward Only Merge true to allow fast-forward-only merges for pull requests; false to prevent them.
Allow Manual Merge true to allow marking pull requests as merged manually; false to prevent it.
Allow Merge Commits true to allow merging pull requests with a merge commit; false to prevent it.
Allow Rebase true to allow rebase-merging pull requests; false to prevent it.
Allow Rebase Explicit true to allow rebase with explicit merge commits (--no-ff); false to prevent it.
Allow Rebase Update true to allow updating pull request branch by rebase; false to prevent it.
Allow Squash Merge true to allow squash-merging pull requests; false to prevent it.
Archived true to archive the repository; false otherwise.
Autodetect Manual Merge true to enable autodetection of manual merges (may have occasional misjudgments); false to disable.
Default Allow Maintainer Edit true to allow maintainers to edit by default; false to disallow.
Default Branch Sets the default branch name for the repository (e.g., "main").
Default Delete Branch After Merge true to delete pull request branches after merge by default; false otherwise.
Default Merge Style Sets the default merge style: one of "merge", "rebase", "rebase-merge", "squash", or "fast-forward-only".
Description A short description of the repository.
Enable Prune true to enable pruning obsolete remote-tracking references when mirroring; false to disable.
External Tracker JSON object representing settings for an external issue tracker integration.
External Wiki JSON object representing settings for an external wiki integration.
Has Actions true to enable actions unit (CI/CD workflows); false to disable.
Has Issues true to enable issues for the repository; false to disable.
Has Packages true to enable package management unit; false to disable.
Has Projects true to enable project boards; false to disable.
Has Pull Requests true to allow pull requests; false to prevent them.
Has Releases true to enable releases unit; false to disable.
Has Wiki true to enable the wiki; false to disable.
Ignore Whitespace Conflicts true to ignore whitespace when checking for conflicts; false to consider whitespace.
Internal Tracker JSON object representing settings for an internal issue tracker integration.
Mirror Interval String specifying mirror interval time (e.g., "8h30m0s").
Name Name of the repository.
Private true to make the repository private; false to make it public. Note: changing visibility may be restricted by organization policies.
Projects Mode Controls project board scope: "repo" for repo-level projects only, "owner" for owner-level projects only, or "all" for both.
Template true to make the repository a template repository; false for a normal repository.
Website URL with more information about the repository.

Output

The node outputs the JSON response from the Gitea API representing the updated repository object. This includes all repository details after the edit operation, reflecting the new settings.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authenticating with the Gitea instance.
  • The node uses the Gitea REST API v1 endpoint at /api/v1.
  • The base URL for the Gitea server must be configured in the credentials.
  • Proper permissions are required to edit the specified repository.

Troubleshooting

  • Error 422 Unprocessable Entity: May occur if trying to change repository visibility (private) but the organization restricts this action to owners only. Solution: ensure you have sufficient permissions or avoid changing visibility.
  • Permission Denied: If the API key lacks rights to edit the repository, the request will fail. Verify that the API token has appropriate scopes.
  • Invalid JSON for External Tracker/Wiki/Internal Tracker: These properties expect valid JSON strings. Malformed JSON will cause errors. Validate JSON syntax before input.
  • Invalid Merge Style: Setting default_merge_style to unsupported values will cause errors. Use one of the allowed options.
  • Network or Authentication Errors: Ensure the Gitea server URL and API key are correctly configured in credentials.

Links and References

Discussion