Documentation

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

Discussion