API Reference

REST endpoints and MCP protocol for programmatic access to VisionDraft.

Base URL

https://visiondraft.space/api

Authentication

All API requests require a VisionDraft API key in the Authorization header:

Authorization: Bearer vd_your_api_key

Generate keys from Settings → API Keys.

MCP Endpoint

POST /api/mcp

JSON-RPC 2.0 transport. Supports all editing, generation, and export tools.

Projects

  • GET /api/projects — List projects
  • POST /api/projects — Create project
  • POST /api/projects/[id]/assets — Upload asset
  • POST /api/projects/[id]/assets/chunked-init — Large file upload

Rendering

  • GET /api/render/[jobId] — Poll render job status

API Keys

  • GET /api/api-keys/current — Current key prefix
  • POST /api/api-keys/regenerate — Regenerate key

Billing

  • POST /api/billing/checkout — Start checkout session
  • GET /api/billing/portal — Customer portal URL

OAuth (MCP clients)

  • GET /.well-known/oauth-authorization-server — OAuth metadata
  • POST /oauth/token — Token exchange
  • POST /oauth/register — Dynamic client registration

For MCP tool schemas, connect your agent and call tools/list. Full tool documentation is available through the MCP protocol.