How to Manage Fastio Intelligence Mode via API

Fastio Intelligence Mode automatically indexes workspace files for semantic search, accessible directly via the API.

When enabled on a workspace, uploads trigger background processing. Documents and code get text extraction, chunking, embedding, and summarization. Files reach "ready" state for RAG queries.

Key capabilities include natural language search like "Q3 contracts with Acme" and chat across folders with source citations. It works across workspaces once Intelligence is enabled.

Competitors require Pinecone or custom DBs. Fastio bundles it as a toggle, saving setup time.

Check Fastio AI docs for chat endpoints.

• How to Manage Fastio API Access Token LifecycleGuide to Fastio API access token lifecycle management: Create scoped API keys with an agent name and an expiry, list...
• Fastio API Presigned URLs Implementation GuideFastio API presigned URLs allow your applications to grant secure, time-limited, direct access to files without...
• How to Build a Fastio API Golang ImplementationBuilding a Fastio API Golang implementation allows developers to manage workspaces, upload files concurrently, and...
• Fastio API vs Google Drive API for AI AgentsWhen building autonomous systems, developers must choose the right storage layer for their AI agents. While the Google...
• How to Automate File Ownership Transfer with Fastio APIAutomating file ownership transfer with the Fastio API lets AI agents securely deliver finished assets to human clients...
• How to Connect the Fastio API to OpenAI AssistantsConnecting Fastio to OpenAI Assistants gives your agents direct access to persistent file workspaces, skipping manual...

More on this subject: Agent Integrations and APIs (96 guides)

Sign up at Fastio and start a 14-day Business Trial. Generate an API key at Settings > API Keys.

Authenticate requests with Authorization: Bearer {token}. Base URL: https://api.fast.io/current/.

Create a test workspace:

curl -X POST "https://api.fast.io/current/org/{org_id}/workspaces/" \\
  -H "Authorization: Bearer {token}" \\
  -d "folder_name=test-ws" \\
  -d "name=Test Intelligence Workspace"

Note the profile_id. Use it for updates.

Use PATCH to toggle:

curl -X PATCH "https://api.fast.io/current/workspaces/{ws_id}/" \\
  -H "Authorization: Bearer {token}" \\
  -d "intelligence=true"

Response confirms "intelligence": true. Existing files reprocess asynchronously.

JavaScript fetch example:

await fetch(`https://api.fast.io/current/workspaces/${wsId}/`, {
  method: 'PATCH',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body: new URLSearchParams({ intelligence: 'true' }),
});

Snippet optimized for featured results.

Enable Intelligence Mode Now

Generous storage, included credits/month. Build RAG workspaces for agents.

Start Business Trial

GET workspace details:

curl "https://api.fast.io/current/workspaces/{ws_id}/" \\
  -H "Authorization: Bearer {token}"

Check "intelligence": true. List files:

curl "https://api.fast.io/current/workspaces/{ws_id}/storage/root/?page_size=20" \\
  -H "Authorization: Bearer {token}"

Files show ai_state: "ready"|"pending"|"in_progress". Poll until ready. ai.attach: true for attachments.

POST to chat endpoint:

curl -X POST "https://api.fast.io/current/workspaces/{ws_id}/ai/chat/" \\
  -H "Authorization: Bearer {token}" \\
  -d "type=chat_with_files" \\
  -d "query_text=What are payment terms?"

Scoped to workspace by default. Use folders_scope=nodeId:3 for folders.

Response streams with citations to nodeId/page/snippet.

PATCH intelligence=false. Stops new indexing, keeps existing. Use for storage-only workspaces to save credits (10/page ingestion).

Monitor usage: GET /org/{org_id}/billing/usage/limits/credits/.

Enable post-creation to avoid reindexing large ws. Test with small files first.

Errors: 413 too large (1GB max), 429 rate limit (headers show remaining).

Credits: Document ingestion 10/page. Included credits reset monthly per plan.

Production: Poll the activity feed or monitor WebSocket events for file status updates, with retries and exponential backoff.