Skip to main content
POST
Save a new agent prompt version

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

id
string
required

Identifier of the agent to checkpoint.

Body

application/json
note
string

Optional note describing what changed in this checkpoint.

Maximum string length: 1000
branch
string

Optional branch label to start or continue an experiment line.

Maximum string length: 120
label
string

Optional human-readable bookmark for this version (e.g. "before Black Friday tweak").

Maximum string length: 200

Response

200 - application/json

The newly minted version row.

data
object

An immutable checkpoint of an agent's versioned configuration, minted on save, promote, or branch. Captures the prompt, model, and settings snapshot for a single version so it can be diffed or restored later.

meta
object