Skip to content
Agents
Workflow apps

List Apps

GET
/v1/apps
curl --request GET \
--url 'https://agents.lumalabs.ai/v1/apps?envelope=false' \
--header 'Authorization: Bearer <token>'

Every workflow app this client's team may run that is offered to partners and has an active release.

An empty list for a team with no entitlements — never an error, and never a hint of what else exists.

envelope
Envelope

Return the catalog as a page, {data, has_more, next_cursor}, like every other list. The bare array is the default until GA, when the page becomes the default.

boolean

Return the catalog as a page, {data, has_more, next_cursor}, like every other list. The bare array is the default until GA, when the page becomes the default.

Successful Response

Media typeapplication/json
Any of:
Array<object>
AppSummaryResponse

One entitled app, as its partner sees it: identity, the document it produces, the renderer that reads it, and what is live right now.

Everything that makes the app what it is — its compiled spec, skills, tool prompts, rubric — stays server-side. A partner runs the app by naming it.

object
current_release
required
AppCurrentRelease

Which release of an app a partner's next session would run. With no release active, an app may serve the package shipped in Luma's code instead; this then describes that package.

object
activated_at
Any of:
string format: date-time
package_digest
required
Package Digest

The release's sealed digest — the identity a session freezes. With no release active, the digest of the package shipped in Luma's code that the session runs.

string
version
required
Version
string
display_name
required
Display Name
string
renderer_key
required
Renderer Key

Kit registry key for this app's plan artifact. Defaults to schema_ref; select registry[renderer_key] ?? registry['default'] so an app sharing another's document schema can still ship its own surface.

string
schema_ref
required
Schema Ref

The plan-artifact schema this app's sessions produce.

string
slug
required
Slug
string
Example
{
"has_more": false
}

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