API Reference

The MantleWP API lets you manage sites, generate reports, and access health data programmatically. All endpoints return JSON.

Base URL

https://mantlewp.com/api

Authentication

MantleWP supports two authentication methods depending on context. Session auth is used by the dashboard via NextAuth.js cookies. API Key auth is used by the WordPress plugin via the X-MantleWP-Key header. See Authentication for details.

Response Format

All responses return a consistent JSON structure. Success responses:

{
  "data": { ... }
}

Error responses:

{
  "error": {
    "message": "Human-readable error",
    "code": "ERROR_CODE",
    "details": { ... }
  }
}

Rate Limiting

Endpoints are rate-limited per API key or session to prevent abuse. When you exceed the limit, the API returns 429 Too Many Requests. Retry after a short delay.

Endpoint Overview

Sites

Reports

Schedules

Branding

Ingest (WordPress Plugin)

Billing

Webhooks

Error Codes