API Endpoints
All endpoints use your IntelligenceBox server URL. Replace BOX_URL with your actual URL (found in Settings → Device Info).
Authentication
Add your API key to every request:
x-api-key: YOUR_API_KEY
# or
Authorization: Bearer YOUR_API_KEYEndpoints
| Endpoint | Method | Auth | Description |
|---|---|---|---|
/health | GET | No | Check server status |
/api/public/vectors | GET | Yes | List all folders |
/api/public/vectors/:id | GET | Yes | Get folder by ID |
/api/public/vectors/:id/files | POST | Yes | Upload a file into a folder |
/api/public/vectors/:id/files | GET | Yes | List files in a folder |
/api/public/vectors/:id/files/:fileId | GET / PUT / DELETE | Yes | Get, replace, or delete a file |
/api/public/vectors/:id/files/:fileId/content | GET | Yes | Download a file |
/api/public/assistants | GET | Yes | List all assistants |
/api/public/assistants/:id | GET | Yes | Get assistant by ID |
/api/ai/chat | POST | Yes | Send chat message |
/api/ai/chat/:id/stop | POST | Yes | Stop response |
Workflow
- Get IDs first - Call List Folders and List Assistants to get the UUIDs you need
- Upload documents (optional) - Upload files into a folder so the AI can search them
- Send chat - Use the IDs in your Chat requests
- Parse response - Handle the streaming SSE response
Quick Test
# Health check (no auth)
curl BOX_URL/health
# List folders (with auth)
curl BOX_URL/api/public/vectors \
-H "x-api-key: YOUR_API_KEY"