Authentication
All memory endpoints (prefixed/v1/) require an API key in the Authorization header:
Memory endpoints
All memory endpoints are namespaced under/v1/ and require a valid API key.
POST /v1/remember
Write to all three memory layers.POST /v1/recall
Search across all three layers and return ranked results.POST /v1/context
Build a token-budgeted context string.GET /v1/stats
Get memory statistics for the current workspace.DELETE /v1/memory
Clear all working memory for an agent.Admin endpoints
Admin endpoints requirePLYRA_ADMIN_API_KEY instead of a regular API key.
POST /admin/keys
Create a new API key.GET /admin/keys/
List all keys for a workspace.DELETE /admin/keys/
Revoke an API key. Revocation is instant.Health endpoint
GET /health
Server health and version info. No authentication required.Error responses
All errors return JSON with adetail field and appropriate HTTP status:
Example error: