> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glider.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Execution Stream

> Replayable server-sent event stream for canonical execution updates.

Use this endpoint when you want direct HTTP streaming for a submitted execution.
It emits the same canonical execution events used by `v2.executions.stream`, but
over standard SSE for CLIs, API integrators, and future chat surfaces.

If you want AG-UI-compatible execution streaming for TanStack AI consumers, use
`GET /v1/ai/executions/:operationId/ag-ui-stream` instead.

## Auth

* Wallet session cookie
* or `X-API-KEY`

## Resume Semantics

* Send `Last-Event-ID` with the opaque stream cursor from the SSE `id` field (the
  same value is also exposed as `cursor` in each event payload).
* The server replays any missed canonical events before switching to live tail.
* `v2.executions.get` and `v2.executions.detail` remain available for snapshot
  hydration and explicit detail fetches.

## Event Envelope

Each SSE message uses a canonical event envelope:

```json theme={null}
{
  "streamId": "execution:op_123",
  "eventId": "1743163201000-0",
  "sequence": 17,
  "ts": "2026-03-28T15:10:00.000Z",
  "kind": "execution.timeline_appended",
  "operationId": "op_123",
  "cursor": "1743163201000-0",
  "payload": {
    "message": "Swap submitted onchain"
  }
}
```

Current execution event kinds:

* `execution.snapshot`
* `execution.state_changed`
* `execution.timeline_appended`
* `execution.progress`
* `execution.result`
* `execution.error`

## Example Call

```bash theme={null}
curl -N \
  --request GET \
  --url 'https://api.glider.fi/v1/executions/op_123/stream' \
  --header 'X-API-KEY: <api-key>'
```

Resume from a previously consumed event:

```bash theme={null}
curl -N \
  --request GET \
  --url 'https://api.glider.fi/v1/executions/op_123/stream' \
  --header 'X-API-KEY: <api-key>' \
  --header 'Last-Event-ID: 1743163201000-0'
```

Example SSE frame:

```text theme={null}
id: 1743163201000-0
event: execution.timeline_appended
data: {"streamId":"execution:op_123","eventId":"1743163201000-0","sequence":17,"ts":"2026-03-28T15:10:00.000Z","kind":"execution.timeline_appended","operationId":"op_123","cursor":"1743163201000-0","payload":{"message":"Swap submitted onchain"}}

```