Assets and media

Read content

Relays the asset bytes through the API.

GET
/v1/assets/{assetId}/content

Returns the file through the API, with X-Content-Type-Options: nosniff. PDF and XML come as attachment. It is the only way to read a confidential asset: the response has Cache-Control: private, no-store and every read is logged.

For photos and videos, prefer the url from Get asset. An asset that is not ready answers 409.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Path Parameters

assetId*string

Identifier of the asset.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

The file, relayed by marketapi, with X-Content-Type-Options: nosniff. PDF and XML come as an attachment. A confidential asset comes with Cache-Control: private, no-store, and every read of one is recorded with the API key or user that made it.

response?unknown
curl -X GET "https://example.com/v1/assets/4a7f2701-c5f7-477f-9658-5ce6be74ef80/content"
null