API ReferenceAgents
Update Version
Update a version.
Allowed status transitions:
DRAFT → ACTIVE(publish) — requires no in-flight build on the version and at least one succeeded build.DRAFT → ARCHIVED— abandon a draft.ACTIVE → ARCHIVED— retire a release.
Other transitions out of ACTIVE or ARCHIVED are rejected; fork a new draft
via POST /versions with parent_version to continue iterating on a frozen
version. Conflicting transitions surface as 409.
Authorization
HTTPBearer AuthorizationBearer <token>
In: header
Path Parameters
agent_id*Agent Id
version*Version
Header Parameters
X-API-Key?string|null
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X PATCH "https://api.levainlabs.com/api/v1/agents/string/versions/0" \ -H "Content-Type: application/json" \ -d '{}'{
"id": "string",
"agent_id": "string",
"version": 0,
"description": "string",
"status": "string",
"parent_version": 0,
"created_at": "string",
"updated_at": "string",
"last_commit_at": "string"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}