ScenebrewDevelopers
API referenceLibrary

Download Asset File

GET
/v1/assets/{asset_id}/files/{role}

One of the asset's stored files by role (files on get_asset: mesh, texture, albedo, normal, …): a 307 to a short-lived presigned URL. With sha256 this is the digest-addressed form an exported entity container carries as an attachment's uri — it keeps resolving after the file was replaced, and never expires itself; the URL it redirects to does. A stored filename (texture.png) is accepted in place of the role for exports made before roles existed. Requires the read scope.

AuthorizationBearer <token>

First-party API key (sbk_live_…), presented as a Bearer token.

In: header

Path Parameters

asset_id*Asset Id
Formatuuid
role*Role

Query Parameters

sha256?|

The digest of the bytes wanted. Served while those bytes are retained, even after the asset's file was replaced; omitted, the current file.

Response Body

application/problem+json

curl -X GET "https://example.com/v1/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/files/string"
Empty