Skip to content
Agents
Outputs

List Session Jobs

GET
/v1/sessions/{session_id}/jobs
curl --request GET \
--url https://agents.lumalabs.ai/v1/sessions/example/jobs \
--header 'Authorization: Bearer <token>'

Every generation job from this session and its descendants, oldest first.

session_id
required
Session Id
string

Successful Response

Media typeapplication/json
SessionJobsResponse
object
jobs
required
Jobs

Every generation job from this session and its descendants, oldest first.

Array<object>
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 format: date-time
created_at
Any of:
string format: date-time
credits_charged
Any of:
integer
credits_estimated
Any of:
boolean
failure_code
Any of:
string
failure_message
Any of:
string
job_id
required
Job Id
string
model
Any of:
string
outputs
Outputs
Array<object>
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
height
Any of:
integer
layer
Any of:
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<string>
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
mime
required
Mime

Exact MIME type, e.g. image/png.

string
model
Any of:
string
size_bytes
Any of:
integer
thumbnail_url
Any of:
string
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
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
{
"jobs": [
{
"outputs": [
{
"layer": {
"alpha_hint": "soft",
"text": {
"font": {
"category": "sans serif",
"match": {
"style": "normal"
},
"weight": "thin",
"width": "condensed"
}
}
}
}
],
"state": "queued"
}
]
}

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"
}
]
}