Skip to content
Agents
Outputs

Read Session Asset

GET
/v1/sessions/{session_id}/assets/{asset_id}
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.

session_id
required
Session Id
string
asset_id
required
Asset Id
string
purpose
required
ReadPurpose

What the URL is for: preview (a thumbnail when one exists) or full (the copy this caller may see).

string
Allowed values: preview full

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
Allowed values: preview full
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>
ValidationError
object
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"
}
]
}