Forgejo icon

Forgejo

Interact with Forgejo API

Overview

This node interacts with the Forgejo API to manage repositories and other related resources. Specifically, for the 'Repository' resource and 'Create' operation, it allows users to create a new repository under the authenticated user's account. Users can specify the repository name, description, privacy setting, and whether to initialize the repository with a README file. This node is useful for automating repository creation workflows, such as setting up new projects or initializing repositories programmatically.

Use Case Examples

  1. Create a new public repository named 'MyProject' with a description and initialize it with a README.
  2. Create a private repository for an organization with a specific description.

Properties

Name Meaning
name Name of the repository to create (required)
description Description of the repository (optional)
private Whether the repository should be private (optional, default false)
autoInit Whether to initialize the repository with a README file (optional, default false)

Output

JSON

  • json - The JSON response from the Forgejo API representing the created repository details

Dependencies

  • Requires an API key credential for Forgejo API authentication

Troubleshooting

  • Ensure the API key credential is correctly configured and has permissions to create repositories.
  • Verify that the repository name is unique and valid according to Forgejo's naming rules.
  • Check network connectivity and the server URL configuration in the credentials.
  • Common errors include authentication failures, invalid parameters, or rate limiting by the Forgejo API.

Links

  • Forgejo API Documentation - Official API documentation for Forgejo, useful for understanding available endpoints and parameters.

Discussion