---
title: "Server-Sent Events: this account's fact writes"
method: GET
path: "/api/v1/events"
---

# Server-Sent Events: this account's fact writes

`GET /api/v1/events`

## Request

- Base URL: `https://ctxstore.ai`
- URL: `https://ctxstore.ai/api/v1/events`
- Auth: HTTP bearer

One `event: fact` frame per fact write (create, supersede, delete, archive, restore, move) with {tenant_id, key, id, namespace, layer, op, ts, seq}. The SSE id is the resume cursor (send it back as Last-Event-ID). Heartbeat comment every 15 s; connections end after 30 minutes with `event: reconnect`; at most 5 concurrent streams per account (429). See docs/events.md.

## Query parameters

- `prefix` string
- `namespace` string
- `since` string

## Headers

- `Last-Event-ID` string

## Response `200`

text/event-stream

## Other responses

- `400`: Bad cursor
- `401`: Missing or invalid API key
- `429`: Too many concurrent streams
- `503`: Event stream unavailable

---

[API](https://skmtc.dev/ctxstore/apis/ctxstore-ai.md) · [All operations](https://skmtc.dev/ctxstore/apis/ctxstore-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/ctxstore/apis/ctxstore-ai/revisions/0581ff18c0f4?raw)