Skip to main content
Research Preview - The pre.dev Architect API is currently in research preview. Features and pricing may change as we continue to improve the platform.

​
Welcome to the pre.dev Architect API

The pre.dev Architect API transforms simple natural language descriptions of software projects into structured specifications optimized for AI coding agents. Input: Plain English descriptions like “Build a chat app” or “Add authentication to my API” Output: Comprehensive technical specifications with implementation milestones, user stories, and task breakdowns

​
Key Features

  • Structured Output: Hierarchical spec format (Milestones → Stories → Subtasks)
  • Task Tracking: Built-in progress management with markdown checkboxes
  • Complexity Estimation: Complexity scores per milestone and subtask
  • Web Sync: Automatic project creation on pre.dev, along with links to open up the project in Cursor, Lovable, Bolt, or v0
  • Documentation Scraping: Automatically scrape and archive external documentation (APIs, frameworks, compliance guides) alongside your spec for complete implementation context

​
How to Use It

The pre.dev Architect API can be integrated in two ways:
  • API Documentation Generation: Generate comprehensive API specs and documentation from natural language descriptions
  • SDK Generation: Create Python or Node.js SDKs with proper type definitions, documentation, and client libraries

​
API Key

Get API Key

Sign up at pre.dev to receive your API key

​
Installation

# No installation required - use curl directly

​
Specification Levels

EndpointUse CaseCostProcessing TimeSubtasks
fast-specQuick prototypes, MVPs10 credits~30-40 secondsHigh-level only
deep-specProduction features, complex systems50 credits~2-3 minutesGranular breakdown
See Choosing Spec Level for detailed comparison.

​
Generating a Fast Spec

Here’s how to generate a specification using the fast-spec endpoint: 
curl -X POST https://api.pre.dev/fast-spec \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "input": "Build a REST API for task management with user authentication",
  }'

​
Response Format

Specs are returned as structured markdown with:
  • Technical Stack: Recommended technologies and dependencies
  • Implementation Milestones: Phased delivery plan with complexity estimates
  • User Stories: Feature requirements with acceptance criteria
  • Subtask Breakdown: Granular implementation steps with checkboxes

​
Task Tracking Format

- [ ] Not started
- [→] In progress
- [✓] Complete
- [\] Skipped

​
Documentation Scraping & Archives

When generating specs, you can optionally provide documentation URLs for external APIs, frameworks, or compliance guides. The Architect API will automatically:
  1. Scrape and archive the documentation in parallel with spec generation
  2. Organize by platform - Each documentation source gets its own ZIP archive
  3. Provide download links - Downloadable ZIP files for your development team

​
Example: Generating a Spec with Documentation

curl -X POST https://api.pre.dev/fast-spec \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "input": "Build a payment system with Stripe integration",
    "docURLs": ["https://stripe.com/docs/api", "https://stripe.com/docs/payments"],
  }'

​
Response Includes Documentation Archives

{
  "codingAgentSpecUrl": "https://api.pre.dev/s/a6hFJRV6",
  "zippedDocsUrls": [
    {
      "platform": "stripe.com",
      "masterZipShortUrl": "https://api.pre.dev/s/xyz789"
    }
  ]
}
Learn more: See Documentation Scraping Guide for advanced usage and best practices.