Skip to content
Agents
Workflow apps

Get App Artifact Schema

GET
/v1/apps/{app_slug}/artifact-schema
curl --request GET \
--url https://agents.lumalabs.ai/v1/apps/example/artifact-schema \
--header 'Authorization: Bearer <token>'

A declared app's artifact schema — what the app's document IS.

app_slug
required
App Slug
string

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<object>
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
tools
Tools
Array<string>
vocabulary
required
Vocabulary

The declared schema document (the authoring source of truth).

object
key
additional properties
any
Examplegenerated
{
"app_slug": "example",
"json_schema": {},
"schema_ref": "example",
"stages": [
{
"completeness": {},
"id": "example",
"slot_pointer": "example",
"tools": [
"example"
]
}
],
"vocabulary": {}
}

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