REST API

All API routes require Authorization: Bearer <api-key>.

What this page covers

Core endpoint groups for entities, search, tasks, sync, graph, and queue status.

Reference

Entity endpoints

• POST /api/entities
• GET /api/entities/:id
• PATCH /api/entities/:id
• DELETE /api/entities/:id
• GET /api/entities

Search

• POST /api/search

Tasks

• POST /api/tasks
• GET /api/tasks
• PATCH /api/tasks/:id
• POST /api/tasks/:id/complete

Document sync

• POST /api/sync/diff
• POST /api/sync/upload
• POST /api/sync/finalize
• POST /api/sync
• GET /api/sync/status/:repo

Knowledge graph

• POST /api/edges
• DELETE /api/edges/:id
• GET /api/entities/:id/edges
• GET /api/entities/:id/graph

Queue / enrichment

• GET /api/queue (optional ?include_failures=true)

Notes

REST returns full JSON payloads. Token-optimized compact formats are handled in MCP/CLI layers.

Create example:

curl -X POST http://127.0.0.1:3100/api/entities \
  -H "Authorization: Bearer $PGM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"memory","content":"project context","tags":["notes"]}'