Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node operation allows you to create or update the status of a specific commit in a repository hosted on a Gitea server. It is useful for integrating continuous integration (CI) pipelines, deployment workflows, or any automated process that needs to report the state of a commit back to the repository. For example, after running tests or builds, you can use this node to mark a commit as "success" or "failure," providing feedback directly in the repository interface.

Properties

Name Meaning
Owner The owner (user or organization) of the repository where the commit exists.
Repo The name of the repository containing the commit.
Sha The SHA hash identifier of the commit to which the status will be attached.
Context A string label to differentiate this status from others (e.g., "ci/build", "code-quality").
Description A short description providing additional details about the status.
State The state of the commit status. Possible values: "pending", "success", "error", "failure".
Target Url A URL linking to more details about the status, such as build logs or deployment pages.

Output

The node outputs JSON data representing the response from the Gitea API after creating or updating the commit status. This typically includes information about the status object created, such as its ID, state, description, context, and related URLs. The output does not include binary data.

Dependencies

  • Requires access to a Gitea instance with API enabled.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The base URL for the Gitea API must be set in the credentials configuration.

Troubleshooting

  • Invalid Credentials or Unauthorized: If the API token is missing or incorrect, the node will fail to authenticate. Ensure the API key has sufficient permissions.
  • Repository or Commit Not Found: Errors occur if the specified owner, repository, or commit SHA do not exist. Double-check these inputs.
  • Invalid State Value: The state property must be one of "pending", "success", "error", or "failure". Using other values may cause errors.
  • Network Issues: Connectivity problems with the Gitea server will prevent the node from completing successfully.
  • To resolve errors, verify all input parameters, ensure correct API credentials, and confirm network accessibility.

Links and References

Discussion