> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/consume-results.md).

# Consume Results

View Cloud Streaming video and JSON results, send results to a webhook, and save a snapshot or short clip.

Choose a result path based on what you need to keep. Live video and "Latest Result" help you inspect a running Workflow. Use a Workflow sink to send selected results to your application, or browser capture to save one moment.

## Choose a result path

<table data-search="false"><thead><tr><th>Need</th><th>Use</th><th>Limit</th></tr></thead><tbody><tr><td>See the camera</td><td>Input preview</td><td>Does not run a Workflow or save video.</td></tr><tr><td>See annotated output</td><td>App player or a live-output watch grant</td><td>Requires an image output and an active watch lease.</td></tr><tr><td>Inspect current predictions</td><td>Latest Result in the app or Agent</td><td>Current results, not durable history or every captured frame.</td></tr><tr><td>Receive every JSON result in your application</td><td><a href="https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/live-results.md">Live results feed</a></td><td>Results from before you connect are not stored.</td></tr><tr><td>Send selected results elsewhere</td><td>Workflow sinks</td><td>Only enabled blocks in the running Workflow send data.</td></tr><tr><td>Keep a snapshot or short clip</td><td>Browser capture to Asset Library</td><td>Requires an open, connected browser until saving finishes.</td></tr></tbody></table>

## Web App

Open "Deployments", then "Cloud Streaming", and select a source. Select the Workflow run you want to inspect when the source has more than one run.

The input preview shows the camera. Workflow output shows the selected image output. A JSON-only Workflow has no video to play.

Open the "Latest Result" tab to see the newest result. Image outputs appear as `image_ref` entries. The app shows only recent results.

To download recent results as JSON lines, open "Logs" in the source's menu and click "Download results". This history is lost when the job stops or restarts. To keep results, use a [Workflow sink](#send-results-with-a-workflow-sink).

<figure><img src="https://1583372177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-39b4835b92704ef19fac1eb2a7e87d3c51374acd%2Fcloud-streaming-shot04-running-results.png?alt=media" alt="Running Workflow with annotated video and Latest Result."><figcaption><p>Compare input video with annotated output and inspect Latest Result. Displayed pricing is illustrative.</p></figcaption></figure>

## Agent

Ask the [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) to show a named camera's live input or the output of a running Workflow. These are different views: watching a camera does not start a Workflow.

For structured output, ask: "Show the latest result from the Workflow I am watching." The Agent reads the watched run's current result; it does not retrieve a history of all predictions.

### Inspect without saving

Ask: "Look at the loading dock camera and tell me whether the door is open." For motion, ask: "Inspect a three-second clip from the loading dock camera."

The Agent looks at a frame or a 1 to 10 second clip (default 3) from the input preview in your browser. Ask a follow-up to reuse the same capture.

Captures stay in the browser for five minutes, up to five per conversation, and are lost on reload.

### Save a snapshot or clip

To keep a temporary inspection, ask: "Save that exact capture to the Asset Library." If it has expired, take a new capture explicitly; the old moment cannot be recovered.

For new media, ask one of the following:

* "Save a snapshot from the loading dock camera."
* "Record five seconds from the loading dock camera and save it to the Asset Library."

A snapshot is a JPEG. A recording is a silent MP4 of 1 to 60 seconds (default 60), up to 128 MiB, at the quality your browser receives.

Keep the conversation open and connected in one browser tab until saving finishes. A recording's "started" response means capture has begun, not that a file exists. Follow its Background Task until it completes and open the returned saved item in the [Asset Library](https://docs.roboflow.com/platform/workspaces/asset-library).

A lost feed or a browser without MP4 recording support can prevent completion. If capture fails, retrying records a later moment. These browser actions are not a public recording API or continuous recording service.

## HTTP API

Use [workspace credentials and the required scopes](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys). Watch live output as video, read every JSON result over the [live results feed](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/live-results.md), or send selected predictions to your application with a [Workflow sink](#send-results-with-a-workflow-sink). Keep returned playback URLs and tokens out of logs, shared links, and source control. A playback grant carries access to the job's output.

### Watch live output

After [starting a job](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/run-a-workflow.md#http-api), wait until it is running, then request a watch grant. Select an image-producing output from the Workflow's interface; a JSON output cannot be played as video.

{% openapi src="/files/HZKHykExD3Pp9vVK5PrS" path="/{workspace}/video-jobs/v1/{jobId}/watch" method="post" %}
[cloud-streaming.yaml](https://1583372177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

For a bounded viewing session:

1. Read the current job and request its watch grant.
2. Pass `whepUrl` to a WHEP-compatible WebRTC player, preserving its full query string. For a built-in player, open the running job in the Web App as described above.
3. Repeat the watch request every 30 seconds while viewing, with the same output selection. Each request extends the publishing lease to at least 60 seconds from that request; use `watch.requestedUntil` to track expiry.
4. If `executionGeneration` changes, the job restarted: request a new watch grant and reconnect.
5. At the end of the viewing session, close the player and stop watch renewals.

The WHEP URL is a signaling endpoint: a player sends an SDP offer with `POST` and uses the SDP answer to establish WebRTC playback. Pasting it into a browser address bar sends `GET` and can return "Method Not Allowed"; that does not establish a playback failure. An RTSP-only player cannot consume this URL.

For RTSP clients, use `rtspsUrl` when the watch response provides it, with a client that supports RTSPS (RTSP over TLS). A `null` value means the job's processing cell does not expose a public RTSPS listener; use WHEP or the app player instead. RTSPS needs the same watch renewals as WHEP.

A job publishes one selected image output at a time. Another viewer's watch request can change that selection for all viewers. Coordinate output selection when sharing a job.

{% hint style="info" %}
Closing a player does not stop a deployment or its billing. A preview stops about 2 minutes after its last watch ends. To end processing, [stop the job](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/manage-and-monitor.md#stop-processing).
{% endhint %}

## Send results with a Workflow sink

Add a [Webhook Sink](https://docs.roboflow.com/workflows/blocks/blocks/data-storage/webhook-sink) to send selected JSON results to an HTTPS endpoint. It runs in Roboflow's cloud, so it cannot reach `localhost` or private addresses.

For a detection alert:

1. Filter detections to the classes and confidence levels you need.
2. Add a [Continue If](https://docs.roboflow.com/workflows/blocks/blocks/logic-and-branching/continue-if) condition so the sink runs only when at least one matching detection remains.
3. Add a Webhook Sink with method `POST`, your destination, and a JSON payload containing the filtered results.
4. Set `cooldown_seconds` to limit repeated sends. Start with `fire_and_forget` set to `false` so you can inspect errors during a controlled test.
5. Test against a non-production receiver, verify its payload and frequency, then enable the intended sink settings in the Workflow you deploy.

Cooldown resets on restart, and delivery is not guaranteed.

Other destinations include [S3 Sink](https://docs.roboflow.com/workflows/blocks/blocks/data-storage/s3-sink) and [Slack Notification](https://docs.roboflow.com/workflows/blocks/blocks/notifications/slack-notification). Files written on the processor are deleted when the job ends.

Enabled sinks send data during previews too, and sinks are on by default. [Promoting a preview](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/run-a-workflow.md#promotion) keeps its sink settings.
