--- title: Get App Artifact Schema | Luma Agents --- GET /v1/apps/{app\_slug}/artifact-schema Select code samplecURL (shell:curl) ```js const url = 'https://agents.lumalabs.ai/v1/apps/example/artifact-schema'; 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/example/artifact-schema \ --header 'Authorization: Bearer ' ``` - Productionagents.lumalabs.ai/v1/apps/{app\_slug}/artifact-schema A declared app's artifact schema — what the app's document IS. ## Authorizations - **[BearerAuth](/api/agents/index.md#bearerauth)** ## Parameters ### Path Parameters **app\_slug** required *App Slug* string ## Responses ### 200 Successful Response Media typeapplication/json *AppArtifactSchemaResponse* A declared app's artifact schema, served for generated UIs and partners: the standard-tooling `json_schema` projection, the stage predicates P4's `deriveStageStatuses` is fed from, and the authoring `vocabulary` document itself. object **app\_slug** required *App Slug* string **json\_schema** required *Json Schema* JSON Schema of the synthesized artifact model (a projection). object ***key*** additional properties any **schema\_ref** required *Schema Ref* The plan-artifact schema the app's sessions produce. string **stages** required *Stages* Array\ *AppArtifactStage* One declared stage: its id, completeness predicate (the closed P10 algebra, evaluated identically by the server and the kit's TS interpreter), the tools that drive it, and the slot pointer its renders land at (None for prose-only stages). object **completeness** required *Completeness* ArtifactPredicate JSON (the declared algebra). object ***key*** additional properties any **id** required *Id* string **slot\_pointer** Any of: - [string](#tab-panel-0-0) - [null](#tab-panel-0-1) string null **tools** *Tools* Array\ **vocabulary** required *Vocabulary* The declared schema document (the authoring source of truth). object ***key*** additional properties any ##### Examplegenerated ```json { "app_slug": "example", "json_schema": {}, "schema_ref": "example", "stages": [ { "completeness": {}, "id": "example", "slot_pointer": "example", "tools": [ "example" ] } ], "vocabulary": {} } ``` ### 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" } ] } ```