Skip to navigation

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

agentIdstringRequired

Request

This endpoint expects an object.
systemPromptstringRequired>=1 character
The full instructions this version proposes.
aliasstringOptional>=1 character

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.

labelstringOptional<=255 characters
notesstringOptional

Why this version exists: the evidence for it, shown in version history.

Response

The proposed version
agentIdstring
aliasstring
changedboolean
False when this alias already pointed at these instructions.
versionIdstring

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error