API reference

Create upload URLs

Re-mint upload URLs for a typed asset's parts

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

Authentication WLT-Api-Key

Create new upload URLs for all or selected roles of a typed multipart asset without recreating its record. Read the guide.

Path parameters

assetstringrequired

Request body

application/jsonRequired

Body of a :createUploadUrls request.

rolesarray<string>

Parts that need new upload grants. Empty selects every declared part.

Responses

`200`

Successful Response

application/json

New upload grants for the requested asset parts.

uploadsarray<UploadGrant>

One new upload grant per requested part role.

`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:createUploadUrls' \  --header "WLT-Api-Key: $WLT_API_KEY" \  --header 'Content-Type: application/json' \  --data '{  "roles": [    "string"  ]}'

Response example200 · JSON

1{2  "uploads": [3    {4      "role": "string",5      "method": "string",6      "url": "https://example.com/image.png",7      "headers": {},8      "expiresAt": "2026-09-14T20:00:00Z"9    }10  ]11}