---
title: "SSE stream of this org's telemetry signals"
method: GET
path: "/v1/otel/stream"
tags: ["Observability"]
---

# SSE stream of this org's telemetry signals

`GET /v1/otel/stream`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/otel/stream`
- Auth: HTTP bearer

Server-sent events carrying spans, metrics and events for the caller's organization. Human users only: an agent must not be able to subscribe to org-wide telemetry.

Every message carries an `id:` field. On reconnect, send the last one back as the `Last-Event-ID` header to resume. If that id has fallen out of the server's buffer, or came from another replica, the stream opens with an `event: gap` message and the client must refetch topology rather than assume continuity. A `gap` is also emitted, without closing the connection, when a subscriber falls behind.

## Query parameters

- `fixture` '1' | 'true'

## Headers

- `Last-Event-ID` string

## Response `200`

An event stream

## Other responses

- `401`: Unauthenticated
- `403`: Not a human user, or fixtures are not available here
- `429`: Too many concurrent streams for this user

---

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