API v1

VibeKit Documentation

Build and deploy full-stack apps with AI. One API call, live URL in minutes.

1 Quickstart

Get an API Key

curl -X POST https://vibekit.bot/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

Submit a Task

curl -X POST https://vibekit.bot/api/v1/task \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Build a todo app with dark mode"}'

Check Status & Get URL

curl https://vibekit.bot/api/v1/task/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer vk_your_api_key

Register

POST /api/v1/auth/register

{"email": "you@example.com"}

Returns your API key + $0.25 free credits.

Tasks

Submit Task

POST /api/v1/task

{
  "prompt": "Build a landing page",
  "skills": ["solana"],        // optional
  "projectId": "abc123",      // optional: iterate
  "callbackUrl": "https://..." // optional: webhook
}

Get Task Status

GET /api/v1/task/:taskId

{
  "taskId": "task_abc123",
  "status": "complete",  // pending | running | complete | error
  "deployUrl": "https://...",
  "repoUrl": "https://github.com/...",
  "projectId": "abc123"
}

Skills

Skills inject domain-specific knowledge into code generation.

GET /api/v1/skills

solana Wallet connection, dApp development, Anchor programs

Webhooks

Get notified when tasks complete. Include callbackUrl in your task submission.

{
  "taskId": "task_abc123",
  "status": "complete",
  "deployUrl": "https://...",
  "repoUrl": "https://github.com/..."
}

Signature Verification: Webhooks include X-VibeKit-Signature header. Verify with HMAC-SHA256 using your API key.

Rate Limits

Plan	Requests/min	Price
Free	10	$0
Pro	30	$9.99/mo
Team	60	$29.99/mo

CLI

# Install
npm install -g vibekit-cli

# Login
vibekit login

# Build something
vibekit build "Create a blog with markdown"

# Check status
vibekit status task_abc123

MCP Server

Use VibeKit as an MCP tool with Claude Desktop.

npm install -g vibekit-mcp

Add to Claude Desktop config:

{
  "mcpServers": {
    "vibekit": {
      "command": "vibekit-mcp",
      "env": {"VIBEKIT_API_KEY": "vk_..."}
    }
  }
}