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

# ViewImage

> Convert a storage URI to a signed viewable URL.

Convert a storage URI (returned in every entity's `uri` field) to a time-limited signed URL that can be displayed in a browser or embedded in a response. Called only when the agent needs to present a visual to the user.

## When to Use

* Show the user an image of a sheet, block, feature, or overlay
* Display a comparison overlay (composite, additions, or deletions layer)
* Present a cropped feature image alongside analysis results
* Attach reference images to an RFI draft

<Info>
  Most queries do not need images. Only call `ViewImage` when the user asks to see something or when a visual reference adds value (e.g., showing an overlay alongside a change description).
</Info>

## Parameters

| Parameter | Type   | Required | Description                                                                                    |
| --------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
| `uri`     | string | yes      | Storage URI from any entity's `uri` field (e.g., `"storage://blocks/blk_a101_plan/image.png"`) |

## Response

```json theme={null}
{
  "url": "https://cdn.bedrock.cv/signed/blk_a101_plan.png?token=...",
  "expires_in": 900
}
```

| Field        | Type   | Description                                                |
| ------------ | ------ | ---------------------------------------------------------- |
| `url`        | string | Signed HTTPS URL, directly viewable in a browser           |
| `expires_in` | number | Seconds until the URL expires (typically 900 = 15 minutes) |

<Warning>
  Signed URLs expire after `expires_in` seconds. Do not cache them beyond that window. Call `ViewImage` again if the URL has expired.
</Warning>

## Examples

### Show an overlay comparison image

```json theme={null}
{
  "uri": "storage://overlays/ov_01/composite.png"
}
```

Returns a signed URL for the composite overlay image showing additions (green) and deletions (red) between two drawing revisions.

### Show a feature crop

```json theme={null}
{
  "uri": "storage://features/ftr_d104/crop.png"
}
```

Returns a signed URL for the cropped image of door 104, useful for attaching to an RFI or including alongside a schedule cross-reference.

## Related Tools

* [`Query`](/mcp/tools/query) - Sheet, block, overlay, and feature responses include `uri` fields
* [`Compare`](/mcp/tools/compare) - Comparison results include overlay `uri` fields
* [`Parse`](/mcp/tools/parse) - Parsed features include `uri` for cropped images