Propose a new agent version
Append a version carrying new instructions and aim a preview alias at it. The agent row, its draft pointer, the published version and the live alias do not move, so no run reaches it unless it names the alias. Repeating the same instructions changes nothing.
Authentication
AuthorizationBearer
API key or Clerk session token
Path parameters
agentId
Request
This endpoint expects an object.
systemPrompt
The full instructions this version proposes.
alias
The preview alias to aim at it. Defaults to otto-proposed- plus the label as a slug, or a hash of the instructions when there is no label.
label
notes
Why this version exists: the evidence for it, shown in version history.
Response
The proposed version
agentId
alias
changed
False when this alias already pointed at these instructions.
versionId
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error