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