---
title: "Get Block Stream Url"
method: POST
path: "/v1beta2/tool/get-block-stream-url"
tags: ["Tools"]
---

# Get Block Stream Url

`POST /v1beta2/tool/get-block-stream-url`

## Request

- Base URL: `https://api.hunch.tools`
- URL: `https://api.hunch.tools/v1beta2/tool/get-block-stream-url`
- Auth: HTTP bearer

This endpoint returns a URL that can be used to stream real-time updatesfor a
specific block in a tool run.

The URL contains a token that is valid for a limited time (1 hour).

The client can use the returned URL with an EventSource connection to receive
real-time updates for the specified block. This url is safe to use in a
frontend application.

## Headers

- `authorization` string, nullable

## Request body

- GetBlockStreamUrlRequest: The request body used to get a signed URL for streaming a block's output.
  - `tool_run_uid` string, required: The unique identifier of the tool run
  - `block_title` string, required: The title of the block to stream

## Response `200`

Successful Response

- GetBlockStreamUrlResponse: The response body returned when requesting a signed URL for streaming a block's output.
  - `stream_url` string, required: The signed URL that can be used to stream the block's output

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error
- `456`: Additional Response

---

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