Nurama Developers
Assets

Get file from asset

Retrieve a specific file from an asset by asset ID and file ID. Requires `canGetAsset`. Private fields (`bucketName`, `tags`, `postProcessingTasks`) are stripped from the response.

GET
/assets/{assetId}/file/{fileId}

Retrieve a specific file from an asset by asset ID and file ID. Requires canGetAsset. Private fields (bucketName, tags, postProcessingTasks) are stripped from the response.

Authorization

AuthorizationBearer <token>

OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.

In: header

Scope: assets:read

Path Parameters

assetId*string

ID of the asset containing the file.

Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Formatuuid
fileId*string

ID of the file to retrieve.

Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Formatuuid

Response Body

application/json

application/json

curl -X GET "https://example.com/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/file/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",  "keyPath": "/project/asset/file123.jpg",  "checksum": "string",  "checksumAlgorithm": "md5",  "name": "string",  "functionType": "original",  "sizeInBytes": 0,  "status": "active",  "meta": {},  "createdAt": 1678886400000,  "updatedAt": 1678886400000}