n8n-nodes-aiteza

A community node for n8n that integrates with the AITEZA REST API.

This node lets you work with AITEZA Datarooms, Files, Web Sources, Search, Chat, Models, and Workflows directly from your n8n workflows. Authentication is handled via OAuth2 (Keycloak Authorization Code flow).

Installation

Community Nodes (recommended)

1. Open your n8n instance.
2. Go to Settings > Community Nodes.
3. Select Install.
4. Enter @aiteza/n8n-nodes-aiteza and confirm.

For more details, see the n8n docs on community nodes.

Environment Variables (n8n v2.21.0+)

If you manage your n8n instance through a deployment pipeline, you can install community packages via environment variables:

export N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV=true
export N8N_COMMUNITY_PACKAGES='[{"name":"@aiteza/n8n-nodes-aiteza","version":"0.1.0"}]'

Restart n8n after setting these. For the full reference, see the n8n environment variable docs.

Manual npm Install (Docker)

If you run n8n in Docker (e.g. in queue mode or for private packages), install directly inside the container:

docker exec -it n8n sh
mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes
npm i @aiteza/n8n-nodes-aiteza

Then restart the container:

docker restart n8n

Credentials

This node authenticates through Keycloak's OAuth2 Authorization Code flow. When you add AITEZA credentials in n8n, a Connect button opens the Keycloak login page. After you sign in, n8n stores and automatically refreshes your tokens.

Configuration

| Field | Description | Default | | ------------- |-------------------------------------------------------------| ------- | | Base URL | Your AITEZA Instance URL, e.g. https://aiteza.example.com | none | | Realm | Keycloak realm name | aiteza | | Client ID | OAuth2 client ID (provided by n8n's OAuth2 base) | none | | Client Secret | OAuth2 client secret (provided by n8n's OAuth2 base) | none |

Supported Resources

| Resource | Operations | | ---------- | ------------------------------------------------------------ | | Dataroom | Get, Get Many, Search, Create, Delete | | File | Get, Get Many, Get Status, Delete, Upload, Upload Standalone | | Web Source | Get Many, Add, Delete | | Search | Hybrid Search | | Chat | Create, Get, Get Messages, Delete, Ask (Ephemeral), Generate | | Model | Get Many | | Workflow | Get, Get Many |

License

MIT