--- title: Read Session Asset | Luma Agents --- GET /v1/sessions/{session\_id}/assets/{asset\_id} Select code samplecURL (shell:curl) ```js const url = 'https://agents.lumalabs.ai/v1/sessions/example/assets/example?purpose=preview'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```sh curl --request GET \ --url 'https://agents.lumalabs.ai/v1/sessions/example/assets/example?purpose=preview' \ --header 'Authorization: Bearer ' ``` - Productionagents.lumalabs.ai/v1/sessions/{session\_id}/assets/{asset\_id} 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 - **[BearerAuth](/api/agents/index.md#bearerauth)** ## Parameters ### Path Parameters **session\_id** required *Session Id* string **asset\_id** required *Asset Id* string ### 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 Allowed values: preview full ## Responses ### 200 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 ```json { "purpose": "preview" } ``` ### 422 Validation Error Media typeapplication/json *HTTPValidationError* object **detail** *Detail* Array\ *ValidationError* object **ctx** *Context* object **input** *Input* **loc** required *Location* Array **msg** required *Message* string **type** required *Error Type* string ##### Examplegenerated ```json { "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ] } ```