---
title: "Get Run Image Signed Url"
method: GET
path: "/v1/runs/{run_id}/image/signed-url"
tags: ["runs"]
---

# Get Run Image Signed Url

`GET /v1/runs/{run_id}/image/signed-url`

## Request

- Base URL: `https://api.cyberdesk.io`
- URL: `https://api.cyberdesk.io/v1/runs/{run_id}/image/signed-url`
- Auth: HTTP bearer

Get a temporary signed URL for a screenshot stored in a run's message history.

The requested image URL must be an exact `supabase://run-images/...` reference
present in the authenticated organization's run.

## Path parameters

- `run_id` string, uuid, required

## Query parameters

- `image_url` string, required: Exact supabase://run-images/... URL from the run_message_history image block to sign.
- `expires_in` integer: URL expiration time in seconds (10-3600).

## Response `200`

Successful Response

- RunImageSignedUrlResponse: Response schema for getting a signed URL for a run screenshot image.
  - `supabase_url` string, required: The stable supabase:// URL from run_message_history
  - `signed_url` string, required: A temporary signed URL for viewing or downloading the image
  - `expires_in` integer, required: Seconds until the signed URL expires

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud.md) - [All operations](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/revisions/5579352ae05e?raw)