API Changelog

Stay up-to-date with all PageGun API changes, new features, and improvements. We follow semantic versioning and maintain backward compatibility for all breaking changes.

Version 1.3.0 — 2024-03-15

🔐 Security & Data Protection

Added

Data Mode encryption — Protect sensitive content with client-side encryption
DELETE /projects/:id/data-mode endpoint for disabling encryption
Enhanced security headers — Added CSP and security headers to all responses
Rate limit headers — X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset in all responses

Security Impact: Data Mode encryption allows you to store sensitive content that only authorized clients can decrypt, perfect for premium content or private documentation.

# Enable Data Mode encryption
curl -X POST "https://api.pagegun.com/projects/proj_abc123/data-mode" \
  -H "Authorization: Bearer $PAGEGUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"encryption_key": "your_secure_key"}'

📊 Analytics & Monitoring

Added

Webhook delivery logs — Track webhook success/failure rates in dashboard
Page performance metrics — Loading times and Core Web Vitals tracking
API usage dashboard — Monitor your API calls and rate limits

Version 1.2.0 — 2024-02-20

🎨 New Section Types

Added

items-review section — Display user reviews and ratings for directory items
more-items section — Show related/recommended items
Enhanced articles-grid — New articleSubroute filter for better content organization

Migration Note: These new sections are backward compatible. Existing pages continue to work unchanged.

// New items-review section
{
  "type": "items-review",
  "heading": "What Users Say",
  "reviews": [
    {
      "rating": 5,
      "title": "Game changer for our team",
      "content": "PageGun saved us months of development time.",
      "author": "Sarah Chen",
      "company": "DevCorp"
    }
  ]
}

🔧 API Improvements

Changed

PUT /pages/:id now returns the complete updated page object instead of just confirmation
Improved error messages — More descriptive validation errors with field-specific guidance
Faster response times — 20% improvement in average API response time

Before:

// Old response
{"message": "Page updated successfully"}

After:

// New response includes full page data
{
  "data": {
    "id": "page_xyz789",
    "page_name": "Updated Page",
    "updated_at": "2024-02-20T10:30:00Z",
    // ... complete page object
  }
}

Version 1.1.0 — 2024-02-01

📚 Documentation Pages

Added

docs page type — Purpose-built for technical documentation
Nested navigation — Automatic sidebar generation from URL structure
Custom markdown directives — Enhanced formatting for docs

New Markdown Directives:

:::callout{type="info"}
This is an info callout box
:::

:::code-tabs
```bash
curl -X GET "https://api.pagegun.com/pages"

const response = await fetch('/api/pages');

:::

First step
Second step
Third step


### 🚀 Publishing Workflow

**Added**
- **`POST /pages/:id/publish`** — Publish draft pages
- **`POST /pages/:id/unpublish`** — Revert published pages to draft
- **Publishing history** — Track when pages were published/unpublished

```bash
# Publish a draft page
curl -X POST "https://api.pagegun.com/pages/page_xyz789/publish" \
  -H "Authorization: Bearer $PAGEGUN_API_KEY"

# Unpublish a live page  
curl -X POST "https://api.pagegun.com/pages/page_xyz789/unpublish" \
  -H "Authorization: Bearer $PAGEGUN_API_KEY"

🐛 Bug Fixes

Fixed

Slug validation — Now correctly allows nested paths for docs type (e.g., api/authentication)
Section ordering — Fixed issue where sections occasionally rendered out of order
Image optimization — Resolved CDN caching issues with hero images

Version 1.0.0 — 2024-01-15

🎉 Initial Release

The foundation of PageGun API

🏗️ Core Infrastructure

Added

RESTful API architecture — Standard HTTP methods with JSON responses
API key authentication — Secure Bearer token authentication
Project management — Multi-project support for agencies and teams
Global CDN — Fast content delivery worldwide

📄 Page Types

Added

page type — JSON-based landing pages with pre-built sections
article type — Markdown blog posts and long-form content
item type — Structured directory entries with custom fields

🎨 Landing Page Sections

Added complete section library:

hero — Compelling headlines with CTAs
problem — Highlight pain points
solution — Show your approach
features — Showcase capabilities
how-it-works — Explain your process
faq — Answer common questions
cta — Drive conversions
content — Flexible text content
testimonials-vertical — Social proof
pricing — Pricing tables and plans

📁 Directory Sections

Added directory-specific sections:

directory-hero — Specialized hero for directory sites
items-grid — Display item collections
articles-grid — Blog/article listings

🛠️ API Endpoints

Complete CRUD operations:

Projects: GET /projects, POST /projects, PUT /projects/:id
Pages: GET /pages, POST /pages, GET /pages/:id, PUT /pages/:id, DELETE /pages/:id
Settings: GET /projects/:id/settings, PUT /projects/:id/settings

🔧 Developer Experience

Added

Comprehensive documentation — Complete API reference and guides
Code examples — cURL, JavaScript, Python examples for all endpoints
Postman collection — Ready-to-use API collection
Webhook support — Real-time event notifications

Breaking Changes Policy

We're committed to maintaining backward compatibility. When breaking changes are necessary:

🔄 Deprecation Process

Announce — 90 days advance notice via email and changelog
Support — Maintain old behavior alongside new implementation
Migrate — Provide clear migration guides and tools
Remove — Remove deprecated features after support period

📢 Staying Updated

Subscribe to updates — Get notified of API changes via email newsletter
Follow the changelog — Bookmark this page for regular updates
Join our Discord — Get real-time updates in our developer community
Check version headers — All API responses include X-API-Version header

🔗 Version Compatibility

API Version	Support Status	End of Life
v1.3.x	✅ Active	Current
v1.2.x	✅ Supported	2024-12-31
v1.1.x	✅ Supported	2024-09-30
v1.0.x	⚠️ Deprecated	2024-06-30

Migration Guides

Upgrading from v1.2 to v1.3

No breaking changes! Simply update your client to take advantage of new features:

// New: Check rate limit headers
const response = await fetch('/api/pages');
const rateLimit = {
  limit: response.headers.get('X-RateLimit-Limit'),
  remaining: response.headers.get('X-RateLimit-Remaining'),
  reset: response.headers.get('X-RateLimit-Reset')
};

Upgrading from v1.1 to v1.2

Enhanced responses: PUT /pages/:id now returns complete page data:

// Before: Only got confirmation
const result = await updatePage(pageId, newData);
// result = { message: "Page updated successfully" }

// After: Get complete updated page
const result = await updatePage(pageId, newData);
// result.data = { id: "page_xyz", page_name: "...", ... }

Upgrading from v1.0 to v1.1

New features only: All v1.0 functionality remains unchanged. New docs page type and publishing endpoints are additive.

Upcoming Features

🚀 Roadmap Preview

Q2 2024

GraphQL API — Alternative query interface for complex data fetching
Bulk operations — Create/update multiple pages in single requests
Advanced webhooks — Filter webhooks by page type, subroute, or custom criteria
Official SDKs — Native libraries for Node.js, Python, Go, PHP

Q3 2024

Real-time collaboration — Multiple users editing pages simultaneously
Version control — Git-like branching and merging for content
A/B testing API — Built-in split testing functionality
Advanced analytics — Conversion tracking and funnel analysis

Q4 2024

Multi-language support — Automatic translation and localization
E-commerce integration — Native Stripe and PayPal section types
Advanced caching — Edge-side includes and dynamic content caching

Support & Feedback

🆘 Getting Help

Documentation — Complete guides at docs.pagegun.com
Discord community — 500+ developers at discord.gg/pagegun
Email support — Technical questions to support@pagegun.com
Feature requests — Vote on new features at feedback.pagegun.com

📝 Contributing

Found an issue or have a suggestion?

Bug reports — GitHub Issues
Feature requests — Feature voting board
Documentation improvements — Docs repository

We love community contributions! 💙