REST API Reference

REST API Reference

Public Endpoints (No Authentication)

GET /cybermaps/v1/discovery Returns all discovery manifest URLs:

{
  "adp": "https://example.com/.well-known/ai.json",
  "llms": "https://example.com/llms.txt",
  "llms_tldr": "https://example.com/llms-tldr.txt",
  "feed": "https://example.com/feed.json",
  "knowledge_graph": "https://example.com/knowledge-graph.json",
  "ai_sitemap": "https://example.com/ai-sitemap.xml",
  "sitemap_index": "https://example.com/sitemap.xml"
}

GET /cybermaps/v1/llms-tldr Returns the TL;DR content as JSON:

{
  "content": "Site Name is a ... [single-paragraph summary with topic clustering]"
}

GET /cybermaps/v1/search?q=search+terms Semantic search with ranking. Returns matching posts sorted by relevance.

GET /cybermaps/v1/identity Returns the Identity Hub JSON-LD data.

Protected Endpoints (API Secret Required)

Send X-Cybermaps-Secret: your-secret-key header.

GET /cybermaps/v1/urls Access the full URL registry.

GET /cybermaps/v1/status Plugin and sitemap health status.

CSRF-Protected Endpoint

POST /cybermaps/v1/purge Requires X-WP-Nonce header. Purges all static files and triggers regeneration.