--- title: List Apps | Luma Agents --- GET /v1/apps Select code samplecURL (shell:curl) ```js const url = 'https://agents.lumalabs.ai/v1/apps?envelope=false'; 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/apps?envelope=false' \ --header 'Authorization: Bearer ' ``` - Productionagents.lumalabs.ai/v1/apps 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. ## Authorizations - **[BearerAuth](/api/agents/index.md#bearerauth)** ## Parameters ### Query Parameters **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. ## Responses ### 200 Successful Response Media typeapplication/json Any of: - [Array\](#tab-panel-0-0) - [ListAppsResponse](#tab-panel-0-1) Array\ *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](#tab-panel-1-0) - [null](#tab-panel-1-1) string format: date-time null **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 *ListAppsResponse* The partner app catalog as a page (`GET /v1/apps?envelope=true`). Every app has an active release, so the catalog fits on one page today: `has_more` is false and `next_cursor` null until it does not. object **data** required *Data* Array\ *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](#tab-panel-2-0) - [null](#tab-panel-2-1) string format: date-time null **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 **has\_more** *Has More* boolean **next\_cursor** Any of: - [string](#tab-panel-3-0) - [null](#tab-panel-3-1) string null ##### Example ```json { "has_more": false } ``` ### 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" } ] } ```