API Documentation

Integrate VEP AI employees into your existing workflows. REST API with JSON responses.

Base URL

https://vep.live/api

Authentication

API requests require an admin token passed via the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Endpoints

GET /api/health

Check platform health. No authentication required.

{
  "status": "ok",
  "version": "1.0.0",
  "uptime": 86400,
  "database": { "status": "connected", "latencyMs": 1 },
  "memory": { "rss": 296, "heapUsed": 153 }
}

POST /api/chat

Send a message to an AI employee. The employee processes the message and returns a reply.

// Request
POST /api/chat
{
  "employee_id": "uuid-of-employee",
  "message": "Find 5 legal tech companies",
  "external_id": "user-123"
}

// Response
{
  "reply": "I found 5 legal tech companies...",
  "conversation_id": "uuid",
  "session_token": "uuid",
  "intent": "research"
}

GET /api/blog/posts

List all published blog posts. No authentication required.

{
  "posts": [
    {
      "id": "uuid",
      "slug": "how-a-law-firm-cut-costs-73",
      "title": "...",
      "hero_stat": "73%",
      "view_count": 12,
      "published_at": "2026-04-02T00:00:00Z"
    }
  ]
}

POST /api/signup

Create a new tenant account.

// Request
POST /api/signup
{
  "email": "[email protected]",
  "name": "Your Name",
  "company_name": "Your Company"
}

// Response
{ "success": true, "message": "Verification code sent" }

Rate Limits

/api/chat: 30 requests/minute per IP

/api/signup: 3 requests/minute per IP

/api/blog/*: 60 requests/minute per IP

SDKs & Integrations

Coming soon: Node.js SDK, Python SDK, Zapier integration, Slack app.

For now, use the REST API directly. Need help? [email protected]