GET /metadata

This endpoint exposes high-level metadata aggregates representing "what the server can see" about an agent. In keeping with the zero-knowledge design, it returns zero plaintext and zero ciphertext—only counts, byte totals, and timestamps.

Request URL

GET /metadata

Response Schema (200 OK)

A JSON object summarizing usage metrics and resource limits:

{
  "envelopeCount": 142,
  "totalBytes": 1048576,
  "storeOps": 142,
  "recallRequests": 890,
  "syncOpsUsed": 142,
  "syncOpsQuota": 1000,
  "devicesInSync": 2,
  "avgLatencyMs": 0,
  "lastSyncAt": "2026-06-09T16:45:30.123Z"
}

Field Catalog

• envelopeCount: Exact count of encrypted envelopes stored in the replication log.
• totalBytes: Cumulative byte size of all stored ciphertext blocks.
• storeOps: Total count of client store operations.
• recallRequests: Best-effort count of client semantic queries (0-RTT queries run locally and are not directly visible to the server).
• syncOpsUsed: Total sync operations consumed.
• syncOpsQuota: Total sync operations allowed in the current billing cycle.
• devicesInSync: Number of active devices linked to the agent key.
• avgLatencyMs: Average network sync latency (set to 0 for client-side local queries).
• lastSyncAt: RFC 3339 timestamp of the last confirmed replication synchronization.