GET /metadata endpoint returns a structured snapshot of everything the server can observe about your agent — and nothing more. In keeping with sovseal’s zero-knowledge design, the response contains only counts, byte totals, and timestamps derived from Layer A (server-visible) metadata. No ciphertext payloads, no decrypted content, and no key material is ever included. Use this endpoint to monitor quota consumption, track active device sync counts, and feed observability dashboards without compromising memory privacy.
All metrics in this response are derived from Layer A server-observable metadata only. The server never decrypts envelopes or inspects memory contents to compute these values.
Request
Response
200 OK
integer
Exact count of encrypted envelopes currently stored in the replication log for this agent.
integer
Cumulative byte size of all stored ciphertext blocks across the entire replication history.
integer
Total count of write (store) operations the client has performed against this agent.
integer
Best-effort count of client semantic query (recall) operations. Note that 0-RTT queries execute entirely locally and are not directly observable by the server — this counter reflects only network-routed recall traffic.
integer
Total sync operations consumed in the current billing cycle.
integer
Total sync operations permitted in the current billing cycle. Compare against
syncOpsUsed to gauge remaining capacity.integer
Number of active devices currently linked to this agent key and participating in replication.
number
Average network sync latency in milliseconds. Returns
0 for client-side local queries that do not transit the network.string
RFC 3339 timestamp of the last confirmed replication synchronization event.