How to Integrate the Fast.io API with n8n Workflows

Fast.io 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 Fast.io workspaces.
• Process Fast.io 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 Fast.io. This guide covers the HTTP Request setups.

Helpful references: Fast.io Workspaces, Fast.io Collaboration, and Fast.io AI.

1. Create a Fast.io account at fast.io (free agent tier 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"

Fast.io 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 Fast.io and n8n

Free agent tier with 50GB storage and API access. Build workflows that connect Fast.io to over 1,300 n8n apps. Built for integrate fast api with n8n workflows workflows.

Sign Up Free

Fast.io 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 Fast.io.

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.

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

1. Webhook Trigger: POST from Fast.io (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 Fast.io AI endpoint.
5. Email Node: Summarize and send.

Webhook URL: Expose via n8n public URL, register in Fast.io 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/.