---
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`

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.net/cyberdesk-hq/apis/cyberdesk-cloud.md) · [All operations](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cyberdesk-hq/cyberdesk-cloud/revisions/830d2f48963d/schema)