--- title: List Session Jobs | Luma Agents --- GET /v1/sessions/{session\_id}/jobs Select code samplecURL (shell:curl) ```js const url = 'https://agents.lumalabs.ai/v1/sessions/example/jobs'; 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/jobs \ --header 'Authorization: Bearer ' ``` - Productionagents.lumalabs.ai/v1/sessions/{session\_id}/jobs Every generation job from this session and its descendants, oldest first. ## Authorizations - **[BearerAuth](/api/agents/index.md#bearerauth)** ## Parameters ### Path Parameters **session\_id** required *Session Id* string ## Responses ### 200 Successful Response Media typeapplication/json *SessionJobsResponse* object **jobs** required *Jobs* Every generation job from this session and its descendants, oldest first. Array\ *JobView* One generation job as the recovery path reports it. The stream is the fast path for the job lifecycle; this is what a client polls when it did not hold the stream open. It answers the same three questions the terminal events do — did it land, why not, what did it cost. object **completed\_at** Any of: - [string](#tab-panel-0-0) - [null](#tab-panel-0-1) string format: date-time null **created\_at** Any of: - [string](#tab-panel-1-0) - [null](#tab-panel-1-1) string format: date-time null **credits\_charged** Any of: - [integer](#tab-panel-2-0) - [null](#tab-panel-2-1) integer null **credits\_estimated** Any of: - [boolean](#tab-panel-3-0) - [null](#tab-panel-3-1) boolean null **failure\_code** Any of: - [string](#tab-panel-4-0) - [null](#tab-panel-4-1) string null **failure\_message** Any of: - [string](#tab-panel-5-0) - [null](#tab-panel-5-1) string null **job\_id** required *Job Id* string **model** Any of: - [string](#tab-panel-6-0) - [null](#tab-panel-6-1) string null **outputs** *Outputs* Array\ *OutputRefView* One landed output of a job, with a freshly presigned URL. Mirrors the SSE `OutputRef` field for field — the stream and the poll must describe an output identically. object **asset\_id** required *Asset Id* Durable artifact identifier for this output. string **duration\_s** Any of: - [number](#tab-panel-7-0) - [null](#tab-panel-7-1) number null **height** Any of: - [integer](#tab-panel-8-0) - [null](#tab-panel-8-1) integer null **layer** Any of: - [OutputLayer](#tab-panel-9-0) - [null](#tab-panel-9-1) *OutputLayer* One layer of a layering output. object **alpha\_hint** required *Alpha Hint* Edge treatment of the layer's transparency — soft (hair/fur/glass), hard (solid edges), or none (the opaque background). string Allowed values: soft hard none **bounds** *OutputLayerBounds* Placement of this layer's pixels within the composite canvas. Absent only when the output's dimensions could not be resolved. object **canvas\_height** required *Canvas Height* Height of the full composite canvas the layers reassemble into. integer **canvas\_width** required *Canvas Width* Width of the full composite canvas the layers reassemble into. integer **height** required *Height* Pixel height of the returned layer image. integer **width** required *Width* Pixel width of the returned layer image. integer **x** required *X* Left offset of this layer's pixels within the composite canvas. integer **y** required *Y* Top offset of this layer's pixels within the composite canvas. integer **contains\_text** *Contains Text* Whether the layer was planned as typeset text (a headline, caption, or label) rather than an image element. Absent when not reported for this output. boolean **description** required *Description* Complete-element caption for the layer's content. string **index** required *Index* Layer position, front-to-back; the last layer is the background. integer **label** required *Label* Short (1-2 word) layer name. string **text** *OutputLayerText* The text read off a contains\_text layer, so it can be re-typeset as live text inside bounds. Absent when the layer holds no text, or its lettering could not be read or is a logo / wordmark. Final whenever the job is. A layering job is not reported finished until reading its text has finished or timed out. object **content** required *Content* The text as shown, preserving capitalization, with a line break between lines. string **decorated** required *Decorated* True when the lettering is ornamental (outlines, patterned fills, bevels, drop shadows), so plain typeset text will not reproduce its look. boolean **font** *OutputLayerFont* Described typeface traits. Absent when they could not be read. object **category** required *Category* Letterform style. string Allowed values: sans serif serif slab serif display sans display serif display slab display decorative handwriting monospace **families** required *Families* Up to three Google Fonts family names that resemble the lettering, closest first. Empty when none of the offered families fit. Array\ **italic** required *Italic* Whether the letters are slanted or cursive. boolean **match** *OutputLayerFontMatch* The font in your font catalog that the lettering matches, so you can re-set the text in it. Absent when no catalog font matches closely enough, or matching is not enabled. The image itself is not rendered in this font. object **face\_id** required *Face Id* Typed ref of the matched face (one weight and style), font\_face:, as typeset actions take it. string **family\_id** required *Family Id* Typed ref of the matched font family, font\_family:. string **family\_name** required *Family Name* Name of the matched font family. string **style** required *Style* Style of the matched face. string Allowed values: normal italic **weight** required *Weight* CSS font weight of the matched face, e.g. 400 or 700. integer **weight** required *Weight* Stroke weight. string Allowed values: thin light regular medium bold black **width** required *Width* Letter width for its height. string Allowed values: condensed normal wide null **mime** required *Mime* Exact MIME type, e.g. image/png. string **model** Any of: - [string](#tab-panel-10-0) - [null](#tab-panel-10-1) string null **size\_bytes** Any of: - [integer](#tab-panel-11-0) - [null](#tab-panel-11-1) integer null **thumbnail\_url** Any of: - [string](#tab-panel-12-0) - [null](#tab-panel-12-1) string null **type** required *Type* Coarse media bucket: image, video, audio, or file. string **url** required *Url* Presigned URL, valid for one hour from this response. string **width** Any of: - [integer](#tab-panel-13-0) - [null](#tab-panel-13-1) integer null **state** required *JobState* The public state of one generation job. `queued` covers every pre-terminal state: nothing observes the moment a task is claimed by a GPU, so claiming otherwise would be a guess. string Allowed values: queued completed failed ##### Example ```json { "jobs": [ { "outputs": [ { "layer": { "alpha_hint": "soft", "text": { "font": { "category": "sans serif", "match": { "style": "normal" }, "weight": "thin", "width": "condensed" } } } } ], "state": "queued" } ] } ``` ### 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" } ] } ```