API ReferenceRuns
Send Message
Iterate on a prior run by sending a follow-up prompt.
A new Run is created, inheriting the previous run's agent, version, and repo
ref. The new prompt enters the graph as plan_text (build recipe) so the
builder treats it as the next task to apply on top of what the previous run
already committed. Lineage is recorded in config.parent_run_id.
Authorization
HTTPBearer AuthorizationBearer <token>
In: header
Path Parameters
run_id*string
Format
uuidHeader Parameters
X-API-Key?|
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://api.levainlabs.com/api/v1/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/messages" \ -H "Content-Type: application/json" \ -d '{ "prompt": "string" }'{
"id": "string",
"recipe": "string",
"status": "string",
"config": {},
"cost_usd": 0,
"tokens_in": 0,
"tokens_out": 0,
"started_at": "string",
"finished_at": "string",
"error": "string",
"agent_id": "string",
"agent_version_id": "string",
"parent_run_id": "string",
"created_at": "string"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}