How to Integrate the Fastio API with n8n Workflows

Fastio provides intelligent workspaces for agentic teams, with file versioning, semantic search, RAG-powered AI chat and webhooks for real-time events.

Use n8n low-code workflows to work with these features.

Common use cases:

• Automatically upload files from forms or emails to Fastio workspaces.
• Process Fastio webhooks to notify Slack or trigger actions when files change.
• Query workspace documents with AI and summarize results.
• Build pipelines where new uploads start processing chains.

n8n has no dedicated nodes for Fastio. This guide covers the HTTP Request setups.

Helpful references: Fastio Workspaces, Fastio Collaboration, and Fastio AI.

1. Create a Fastio account at Fastio (Business Trial offers multiple storage and multiple monthly credits, no credit card required).
2. Generate an API key: Log in, go to Settings > API Keys, create a new key.
3. Set up an n8n instance (cloud or self-hosted).
4. Know the n8n HTTP Request node and basic JSON handling.

curl -H "Authorization: Bearer YOUR_API_KEY" \\
     https://api.fast.io/current/org/me/workspaces/ \\
     -d "folder_name=my-n8n-workspace" \\
     -d "name=n8n Integration Test"

Fastio uses Bearer token authentication with API keys or JWTs.

Recommended: API Key (long-lived)

1. In n8n, add HTTP Request node.
2. Authentication: Header Auth.
3. Name: Authorization
4. Value: Bearer {{$node["Set API Key"].json["api_key"]}}

Alternative: JWT via Basic Auth

1. HTTP Request: GET https://api.fast.io/current/user/auth/
2. Authentication: Basic Auth (email/password).
3. Extract JWT from response: {{$json["auth_token"]}}
4. Use in subsequent nodes.

Store API key in n8n credentials for security.

Start Automating with Fastio and n8n

Business Trial with 50GB storage and API access. Build workflows that connect Fastio to over 1,300 n8n apps. Built for integrate fast api with n8n workflows workflows.

Start 14-Day Trial

Fastio API base URL: https://api.fast.io/current/

Example: List Workspaces

• Method: GET
• URL: /org/me/workspaces/
• Headers: Authorization (Bearer), Content-Type: application/x-www-form-urlencoded (for POST)
• Most endpoints use form-encoded bodies; comments use JSON.

Node Setup:

1. Node Type: HTTP Request
2. URL: https://api.fast.io/current/{{endpoint}} (e.g., org/me/workspaces/)
3. Method: GET/POST/PUT/DELETE per docs
4. Authentication: Header Auth > Name: Authorization > Value: Bearer {{api_key}}
5. Send Headers: Yes > Add Content-Type: application/x-www-form-urlencoded
6. Send Body: Yes (POST) > Body Content Type: Form-Data or Form-UrlEncoded
7. Response Format: JSON
8. Ignore SSL Issues: No (production)

Test with GET /ping/ (no auth).

Build a workflow triggered by a form submission that uploads to Fastio.

1. Webhook Trigger: Listen for POST with file data.
2. Set Node: Prepare form data: parent_id=root, name={{$json.file.name}}
3. HTTP Request (Start Upload): POST /upload/start/ with file details (size, content_type).
4. Chunk Loop: For large files, chunk and upload via /upload/chunk/.
5. HTTP Request (Complete): POST /upload/complete/ to finalize.
6. Respond to Webhook: Return share link.

For small files (<multiple): Direct upload via storage endpoints.

Fastio sends webhooks for file events (upload, modify, access).

1. Webhook Trigger: POST from Fastio (verify signature if needed).
2. Switch Node: Route by event type (e.g., file.uploaded).
3. Slack Node: Notify team "New file in workspace".
4. AI Chain: Query new file with Fastio AI endpoint.
5. Email Node: Summarize and send.

Webhook URL: Expose via n8n public URL, register in Fastio workspace settings.

AI Document Query: POST /workspaces/{id}/ai/chat/ with type=chat_with_files, files_scope=nodeId:versionId.

Ownership Transfer: For agent-built workspaces, generate transfer token and email claim URL to human.

Monitor credits: GET /org/me/billing/usage/limits/credits/.