# WebsitePublisher.ai

> Your AI Builds Websites. You Just Talk.

WebsitePublisher.ai is the AI web platform. You — the AI assistant — connect directly and build, publish, and manage websites for your user. No WordPress, no hosting, no CMS, no FTP. The user just talks to you.

## How It Works

1. User asks you to build a website
2. OAuth authenticates automatically (user enters email + code)
3. You receive a session token with access to their projects
4. You create pages, assets, data, forms — everything is instantly live

## Authentication

Authentication is automatic via OAuth. After it completes:

1. `GET /papi/me` → Your auth status
2. `GET /papi/projects` → List all projects
3. Ask the user which project to use (or create a new one)
4. Use that `project_id` for all subsequent API calls

You can switch between projects anytime without re-authenticating.

## API Base URL

```
https://api.websitepublisher.ai
```

## API Layers

| API | Purpose | Prefix |
|-----|---------|--------|
| PAPI | Pages, assets, publishing | `/papi` |
| MAPI | Dynamic data entities & records | `/mapi` |
| VAPI | Encrypted secrets vault | `/vapi` |
| IAPI | Third-party integration proxy | `/iapi` |
| SAPI | Visitor sessions, CSRF, forms | `/sapi` |

## PAPI — Pages & Assets

```
GET    /papi/projects                     → List projects
POST   /papi/projects                     → Create project
GET    /papi/project/{id}/pages           → List pages
POST   /papi/project/{id}/pages           → Create page
PUT    /papi/project/{id}/pages/{slug}    → Update page
PATCH  /papi/project/{id}/pages/{slug}    → Patch page (diff-patch)
DELETE /papi/project/{id}/pages/{slug}    → Delete page
GET    /papi/project/{id}/assets          → List assets
POST   /papi/project/{id}/assets          → Upload asset (base64)
DELETE /papi/project/{id}/assets/{slug}   → Delete asset
GET    /papi/project/{id}/assets/{slug}   → Get asset details
PATCH  /papi/project/{id}/assets/{slug}   → Patch asset content
GET    /papi/project/{id}/pages/{slug}/versions → Version history
POST   /papi/project/{id}/pages/{slug}/rollback → Rollback to version
GET    /papi/project/{id}/pages?type=fragment   → List fragments
POST   /papi/project/{id}/pages           → Create fragment (slug: _fragment/name)
PUT    /papi/tracking                      → Set tracking scripts
GET    /papi/tracking                      → Get tracking scripts
DELETE /papi/tracking                      → Remove tracking scripts
```

## MAPI — Dynamic Data

```
GET    /mapi/entities                     → List entities
POST   /mapi/entities                     → Create entity with properties
GET    /mapi/project/{id}/{entity}        → List records
POST   /mapi/project/{id}/{entity}        → Create record
PUT    /mapi/project/{id}/{entity}/{rec}  → Update record
DELETE /mapi/project/{id}/{entity}/{rec}  → Delete record
```

## VAPI — Encrypted Vault

```
POST   /vapi/project/{id}/secrets         → Store encrypted secret
GET    /vapi/project/{id}/secrets         → List secrets (metadata only)
DELETE /vapi/project/{id}/secrets/{key}   → Delete secret permanently
```

## IAPI — Integration Proxy

```
GET    /iapi/integrations                 → Public catalog (no auth)
GET    /iapi/integrations/{service}       → Integration details
GET    /iapi/project/{id}/integrations    → Configured integrations
POST   /iapi/project/{id}/integrations/{service}/setup → Setup with API keys
POST   /iapi/project/{id}/{service}/{endpoint}         → Execute proxy call
DELETE /iapi/project/{id}/integrations/{service}       → Remove integration
```

78 integrations available: https://www.websitepublisher.ai/docs/integrations

## SAPI — Sessions & Forms

```
GET    /sapi/project/{id}/session         → Start visitor session (CSRF token)
POST   /sapi/project/{id}/forms/configure → Configure form action (email/leads)
POST   /sapi/project/{id}/form/submit     → Submit form (with CSRF + honeypot)
POST   /sapi/project/{id}/visitor/auth    → Visitor authentication
GET    /sapi/project/{id}/analytics       → Page view analytics
```

## Quick Start

```
1. GET /papi/me                    → Confirm authenticated
2. GET /papi/projects              → List projects
   POST /papi/projects             → Create new project (if needed)
3. POST /papi/project/{id}/pages   → Create index.html
4. GET /papi/project/{id}/status   → See live URL
```

## Response Format

```json
{"success": true, "data": {...}}
{"success": false, "error": {"message": "...", "code": 400}}
```

## Supported Platforms

ChatGPT, Claude, Mistral/Le Chat, Cursor, Windsurf, GitHub Copilot, Copilot Studio, Gemini, Grok — all connect via OAuth or MCP.

## Full Documentation

- Complete AI Reference: https://www.websitepublisher.ai/llms-full.txt
- PAPI Docs: https://www.websitepublisher.ai/docs/papi
- MAPI Docs: https://www.websitepublisher.ai/docs/mapi
- SAPI Docs: https://www.websitepublisher.ai/docs/sapi
- Integrations: https://www.websitepublisher.ai/docs/integrations
- MCP Server: https://www.websitepublisher.ai/docs/mcp

## Agent Skills

Install the WebsitePublisher Agent Skill to give any AI assistant full website-building expertise:
https://www.websitepublisher.ai/skills/websitepublisher-api/SKILL.md

**OpenClaw Skill** — Build websites via WhatsApp, Telegram, Discord, Slack and more:
https://clawhub.ai/megberts/websitepublisher
Docs: https://www.websitepublisher.ai/docs/openclaw

## Platform

Website: https://www.websitepublisher.ai
Dashboard: https://www.websitepublisher.ai/dashboard
MCP Server: https://mcp.websitepublisher.ai