---
title: "Stream Agent Spec execution updates (WebSocket)"
description: "WebSocket endpoint for real-time execution updates.\nStreams per-node status changes and execution events as they occur.\n\n**Protocol**: WebSocket (upgrade from HTTP)\n\n**Messages sent by server**:\n- `{\"type\": \"node_status\", \"node\": \"<name>\", \"status\": {...}}`\n- `{\"type\": \"execution_complete\", \"results\": {...}}`\n- `{\"type\": \"execution_error\", \"error\": \"<message>\"}`\n"
source: https://flowdrop.io/docs/api/agent-spec/agentSpecStreamExecution
site: FlowDrop documentation
---
# Stream Agent Spec execution updates (WebSocket)
`GET /agentspec/executions/{id}/stream`

WebSocket endpoint for real-time execution updates.
Streams per-node status changes and execution events as they occur.

**Protocol**: WebSocket (upgrade from HTTP)

**Messages sent by server**:
- `{"type": "node_status", "node": "<name>", "status": {...}}`
- `{"type": "execution_complete", "results": {...}}`
- `{"type": "execution_error", "error": "<message>"}`

## Parameters

- `id` · in path · string · required — Execution ID from the runtime

## Responses

- `101` — WebSocket upgrade successful
- `200` — WebSocket connection established (upgrade to ws://)
- `404` — Resource not found (`application/json`: ErrorResponse)

*Tags: Agent Spec*