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 the "indexed" 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 (192 guides)

Sign up at Fastio and start a 14-day Business Trial. Generate an API key at Settings > Devices & Agents > 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}/create/workspace/" \
  -H "Authorization: Bearer {token}" \
  -d "folder_name=test-ws" \
  -d "name=Test Intelligence Workspace" \
  -d "perm_join=Member or above" \
  -d "perm_member_manage=Admin or above" \
  -d "intelligence=false"

A new workspace has intelligence on unless you send intelligence=false, as this test does. Note the returned workspace.id. Use it for updates.

Use the workspace update route to toggle:

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

Response returns "result": true. Existing files reprocess asynchronously.

JavaScript fetch example:

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

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/workspace/{ws_id}/details/" \
  -H "Authorization: Bearer {token}"

Check "intelligence": true. List files:

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

Each file's ai.state shows pending, in_progress, ready, indexed or failed. Poll until indexed. ai.attach: true for attachments.

POST to chat endpoint:

curl -X POST "https://api.fast.io/current/workspace/{ws_id}/ai/agent/" \
  -H "Authorization: Bearer {token}" \
  -d "question=What are payment terms?"

Scoped to workspace by default. To focus on a folder, attach it as a folder reference item in the references array.

Response streams with citations to nodeId/page/snippet.

POST intelligence=false to the same update route. Disabling flushes the indexed embeddings, and re-enabling re-indexes all files at AI credit cost. Use for storage-only workspaces to save credits (10/page ingestion).

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

Test with small files first.

Errors: 412 too large (over 25 GB on Starter, 50 GB on Business or 100 GB on Enterprise), 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.