# n8n-nodes-fox

Interact with the [Fox](https://fox.innovationspartner-mittelstand.de/) API from your [n8n](https://n8n.io/) workflows. This node package allows you to automate project management, monitor status changes, and trigger actions for innovative R&D projects via the Fox API.

**Author:** Leon Chemnitz

- [Installation](#installation)
- [Supported Nodes](#supported-nodes)
- [Credentials](#credentials)
- [Usage](#usage)
- [Resources](#resources)
- [Version history](#version-history)

## Installation

To install this community node, follow the [n8n community nodes installation guide](https://docs.n8n.io/integrations/community-nodes/installation/).

## Supported Nodes

This package includes three nodes for comprehensive Fox API integration:

### Fox Project
Comprehensive project management operations including:
- Get all projects and project details
- Create, update, rename, copy, and delete projects
- Project versioning and restoration
- Work package management
- Project schema and examples

### Fox Action Trigger
Webhook-based trigger for Fox actions:
- Automatically creates and manages webhooks
- Listens for `action.triggered` events
- Filters by specific action ID
- Returns action execution data

### Fox Status Change
Webhook-based trigger for project status changes:
- Monitors project state transitions
- Filters by previous and new status
- Supports all project states: idea, draft, for_sale, under_review, success, faulty
- Returns project change information

## Credentials

You need a Fox API account. The following credentials are required:

- **API URL** - The base URL for your Fox API instance
- **Access Token** - Your Fox API access token

## Usage

### Fox Project Node

Use the Fox Project node to manage your R&D projects:

- **Get Projects**: Retrieve all projects or specific project details
- **Create Project**: Start new innovative projects with draft data
- **Update Project**: Modify project status, research data, and work packages
- **Version Management**: Create versions and restore previous project states
- **Work Packages**: Submit and manage work package lists

### Fox Action Trigger

Set up automated workflows triggered by Fox actions:

1. Select the action you want to monitor
2. The node automatically creates a webhook
3. When the action is triggered, your workflow executes
4. Access action data including project info and execution details

### Fox Status Change

Monitor project status transitions:

1. Configure filters for previous and new status
2. The node creates a webhook for status change events
3. Your workflow triggers when projects change state
4. Access project change information including who made the change

## Resources

- [Fox API Documentation](https://fox.innovationspartner-mittelstand.de/api/spec/)
- [Fox Webhooks Documentation](https://fox.innovationspartner-mittelstand.de/api/spec/webhooks)
- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)

## Version History

- **v0.1.0**: Initial release