Read Session Asset
GET
/v1/sessions/{session_id}/assets/{asset_id}
const url = 'https://agents.lumalabs.ai/v1/sessions/example/assets/example?purpose=preview';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://agents.lumalabs.ai/v1/sessions/example/assets/example?purpose=preview' \ --header 'Authorization: Bearer <token>'A short-lived URL for an asset the session's plan artifact names, or for one of its ready deliveries.
preview serves the thumbnail when there is one; full serves the
copy this session may see. An asset the session does not name, or one
this session's workspace does not hold, answers the same 404 as an unknown one.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”session_id
required
Session Id
string
asset_id
required
Asset Id
string
Query Parameters
Section titled “Query Parameters”purpose
required
ReadPurpose
What the URL is for: preview (a thumbnail when one exists) or full (the copy this caller may see).
string
Responses
Section titled “ Responses ”Successful Response
Media typeapplication/json
SessionAssetRead
A short-lived URL for one asset the session's plan artifact names, or one of its ready deliveries.
object
asset_id
required
Asset Id
The asset, as the plan artifact names it.
string
purpose
required
ReadPurpose
What the URL answers: preview or full.
string
url
required
Url
Signed URL serving the bytes; expires, so read it again rather than storing it.
string
Example
{ "purpose": "preview"}Validation Error
Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{ "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ]}