---
title: "Subscribe to live governance signal updates (SSE)"
method: GET
path: "/realtime/governance"
tags: ["Governance"]
---

# Subscribe to live governance signal updates (SSE)

`GET /realtime/governance`

## Request

- Base URL: `https://api.mnemom.ai/v1`
- URL: `https://api.mnemom.ai/v1/realtime/governance`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Mnemom-Api-Key`

Server-Sent Events stream that emits one `event: signal` per `governance_signals` insert/update matching the caller's filter. For `scope=org|agent` it ALSO emits an `event: agent.claimed` frame (`{agent_id, org_id, name, claimed_at}`) when an agent is claimed into the scope, so an open dashboard shows it appear live (Dojo MNE-521). RBAC mirrors the REST list endpoints: `scope=platform` requires Mnemom staff; `scope=org|team|agent` requires membership of the org that owns the named scope id: `scope=org` needs `org_id`, `scope=team` needs `team_id` and `scope=agent` needs `agent_id` (400 without it), and every non-platform stream carries only rows of that one org. The stream emits an initial `event: ready` marker, then events as they arrive, plus periodic `:heartbeat` comments. Connection lifetime is capped at 5 minutes — clients should reconnect.

## Query parameters

- `scope` 'platform' | 'org' | 'team' | 'agent'
- `org_id` string
- `team_id` string
- `agent_id` string

## Response `200`

SSE stream of governance signal events.

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `404`: Resource not found
- `429`: Rate-limit exceeded. The global per-IP limiter (100 requests/minute, applied to every `/v1/*` route) rejected this request. Back off until the window resets — `Retry-After` carries the cooldown in seconds and `X-RateLimit-Reset` the absolute reset time.
- `500`: Server error — request was well-formed but the server failed to fulfill it. Typically a downstream dependency (DB / RPC / external API) returned an unexpected error.

---

[API](https://skmtc.dev/mnemom/apis/mnemom-api.md) · [All operations](https://skmtc.dev/mnemom/apis/mnemom-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mnemom/apis/mnemom-api/revisions/274b7a6ea182?raw)