Levain LabsLevain Labs
API ReferenceAgents

Get Agent State Schema

Return the recipe's user-input schema for the latest active version.

Describes the shape of initial_state accepted by POST /agents/{id}/runs and POST /sessions/{id}/messages — which fields the recipe declares, their types, and which one a bare prompt is auto-routed into. The same schema is enforced on dispatch.

GET
/api/v1/agents/{agent_id}/state-schema

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

agent_id*Agent Id

Header Parameters

X-API-Key?string|null

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.levainlabs.com/api/v1/agents/string/state-schema"
null
{
  "code": "NOT_PROVISIONED",
  "message": "string",
  "details": "string"
}
{
  "code": "NOT_PROVISIONED",
  "message": "string",
  "details": "string"
}
{
  "code": "NOT_PROVISIONED",
  "message": "string",
  "details": "string"
}