Getting Started with AIPI

This guide walks you through using Intuidy as the complete backend for your application — from setting up your account to deploying a working app with a fully managed BaaS behind it.

Prerequisites

Before you start, you'll need:

Step 1: Set Up Your Vantage Account

1. Sign up at the Vantage platform and complete the registration wizard
2. Create a company — this is the data boundary for your application
3. Configure integrations — connect the databases and services your app will use (see Connecting Integrations)

Configure Your Data Layer

Set up the database connections your application needs:

• Navigate to Integrations in the Vantage sidebar
• Add database adapters (PostgreSQL, MySQL, MongoDB, etc.)
• Create any initial tables or collections your application requires

Step 2: Build Your Frontend

Use any technology to build your application's user interface:

Your frontend handles:

• User interface — what users see and interact with
• Local state — form data, UI state, navigation
• AIPI calls — requests to the Vantage backend for data, AI, and workflow operations

Step 3: Connect to AIPI

Point your frontend at the Vantage backend by configuring your AIPI connection:

1. Get your API credentials from the Vantage Settings page
2. Configure your application to send authenticated requests to the AIPI endpoints
3. Test the connection by making a simple data query

Connection Pattern

1. User interacts with your frontend UI
2. App sends an AIPI request — authenticated, with relevant data
3. Vantage processes the request — database query, workflow execution, AI analysis, or any combination
4. Structured response returned to your app, ready to display

Step 4: Build Your Workflows

Create the backend logic your application needs. Because AIPI is fully headless, you have two paths:

Option A: Let Your Agentic IDE Build Them

Your AI coding assistant (Cursor, Claude, Windsurf, etc.) can create and manage workflows programmatically through the REST API:

curl -X POST https://your-instance.com/api/v1/workflows \
  -H "Authorization: Bearer vntg_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Customer Lookup",
    "nodes": [
      { "node_type": "triggers/workflowInput", "node_role": "getter", "label": "Input" },
      { "node_type": "database/query", "node_role": "setter", "label": "DB Lookup" },
      { "node_type": "termination/workflowOutput", "node_role": "terminator", "label": "Output" }
    ],
    "edges": [
      { "source_node_index": 0, "target_node_index": 1 },
      { "source_node_index": 1, "target_node_index": 2 }
    ]
  }'

Your IDE can discover available node types via GET /api/v1/node-types, then compose and deploy workflows entirely from code — no browser required.

Option B: Build Manually in the Visual Editor

1. Navigate to Workflows in Vantage
2. Create a new workflow for each backend operation
3. Use Workflow Input nodes to receive data from your AIPI calls
4. Add processing nodes (database queries, AI analysis, transformations)
5. Use Workflow Output nodes to return results to your application

Example: Customer Lookup Workflow

See Building Workflows for the full workflow guide.

Step 5: Deploy Your Application

Host your frontend wherever you prefer — AIPI works with any hosting provider:

Step 6: Configure AI Agents (Optional)

Deploy AI agents that can act on your application's data:

1. Navigate to Agent Hub in Vantage
2. Create a new agent with the Agent Builder
3. Assign skills, connect data resources, and write a system prompt
4. Deploy the agent — it becomes accessible through AIPI

Your application can send messages to the agent, and the agent can:

• Answer questions using your connected data
• Execute workflows on demand
• Create dashboards and reports
• Interact with connected integrations

See Agent Builder for the full agent setup guide.

What Happens Next

Once your application is connected to AIPI, you can incrementally add capabilities:

Next Steps

• API Builder Integration — Extend AIPI with custom third-party integrations
• Security & Authentication — Configure access control for your application
• Use Cases & Examples — See real-world application patterns