API reference

Create read URL

Mint a signed read URL for an asset

POST/api/v2/assets/{asset}:createReadUrl

Authentication WLT-Api-Key

Create a short-lived download URL for one asset. Fetch it without sending the World Labs API key. Read the guide.

Path parameters

assetstringrequired

Responses

`200`

Successful Response

application/json

A short-lived credential for downloading one asset.

readUrlstringrequired

Short-lived download URL for the asset's bytes. Anyone with the URL can read the asset until it expires; create a fresh one rather than persisting this.

expiresAtstringrequired

When readUrl stops authorizing the download.

Formatdate-time

`422`

Validation Error

application/json

detailarray<ValidationError>

Request example

cURL

curl --request POST \  --url 'https://api.atlas-beta.worldlabs.ai/api/v2/assets/asset_01jexample000000000000000:createReadUrl' \  --header "WLT-Api-Key: $WLT_API_KEY"

Response example200 · JSON

1{2  "readUrl": "https://example.com/image.png",3  "expiresAt": "2026-09-14T20:00:00Z"4}