---
title: "Resolve a runtime download URL"
method: POST
path: "/v1/downloads/resolve"
---

# Resolve a runtime download URL

`POST /v1/downloads/resolve`

Resolves a runtime limulator download URL into the internal download bundle shape.
URLs that point at Limrun-owned asset-storage buckets may be upgraded to a
header-signed TAG request with the original URL as fallback, but only after
the original URL successfully authorizes a one-byte probe. Other URLs are
returned unchanged. Possession of the source URL is the authorization
capability for this endpoint.

## Request body

- ResolveDownloadRequest
  - `url` string, required

## Response `200`

Resolved download request

- ResolvedDownload
  - `url` string, required
  - `headers` object
  - `fallbackUrl` string
  - `fallbackHeaders` object

## Other responses

- `default` — Error

---

[API](https://skmtc.net/limrun-inc/apis/limrun-api.md) · [All operations](https://skmtc.net/limrun-inc/apis/limrun-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limrun-inc/limrun-api/revisions/0a3cd7959546/schema)