System Architecture
AIPI turns the Vantage platform into a fully headless Backend as a Service (BaaS). Your systems, apps, and software connect to Intuidy as their backend — no servers to build, no infrastructure to manage. This page explains how the layers fit together and how requests flow through the system.
Layered Architecture
AIPI follows a layered BaaS design where your application consumes backend services without managing any of the underlying infrastructure:
Layer Responsibilities
| Layer | What It Does |
|---|---|
| Your Application | The frontend you build — handles UI, user interactions, and local state |
| AIPI Layer | Authenticates requests, routes them to the correct service, enforces rate limits and permissions |
| Vantage Core Services | Processes business logic — executes workflows, runs AI agents, manages integrations, generates dashboard data |
| Data Layer | Stores and retrieves data from connected databases, manages file storage, and handles event streaming |
Request Lifecycle
When your application makes an AIPI request, it follows this path:
- Your app sends an authenticated request
- AIPI validates credentials and permissions
- Request is routed to the appropriate Vantage service
- The service processes the request (query data, execute workflow, call AI, etc.)
- Response is formatted and returned to your app
Authentication Flow
Every AIPI request requires authentication. The platform supports:
| Method | How It Works | Best For |
|---|---|---|
| API Key | Include your key in the request header | Server-to-server communication, backend services |
| Session Token | Authenticate users through the Vantage login flow | User-facing applications where individuals sign in |
Multi-Tenant Isolation
AIPI inherits the Vantage multi-tenant architecture. Data is isolated at the company level:
- Each API key is scoped to a specific company
- Requests can only access data, workflows, and integrations belonging to that company
- Cross-company access requires organization-level permissions
- All API activity is logged for audit purposes
Core Service Connections
AIPI connects your application to every major Vantage subsystem:
| Service | What AIPI Exposes |
|---|---|
| Workflow Engine | Trigger workflows, pass input data, retrieve output results, monitor execution status |
| Dashboard Engine | Read dashboard data, push data from external sources into dashboard tiles |
| AI System | Send prompts to configured AI models, deploy and manage AI agents |
| Integrations | Access connected services (email, calendar, storage, CRM, etc.) through a unified interface |
| Database Layer | Execute queries, insert/update/delete records, manage schemas |
| Security | Manage users, roles, and permissions programmatically |
Data Flow Patterns
Read Pattern
Your app requests data → AIPI authenticates → Vantage queries the data source → structured response returned.
Write Pattern
Your app sends data → AIPI validates and authenticates → Vantage writes to the target database or service → confirmation returned.
Trigger Pattern
Your app fires an event → AIPI routes to the Workflow Engine → workflow executes (can involve multiple services, AI analysis, notifications) → final result returned or pushed asynchronously.
Agent Pattern
Your app sends a message to an AI agent → AIPI routes to the deployed agent → agent processes using its skills, data resources, and tools → response streamed back.
Next Steps
- Core Capabilities — What you can do with each service
- Getting Started — Build your first AIPI-powered application