Add a revision
Appends a revision to an agent, instructions or code, and makes it the one runs use. Revisions are never changed or removed.
Authorizations
Customer API key (axl_ prefix).
Path Parameters
The agent's id.
Body
Request body for adding a revision. The new revision becomes the agent's current one.
code needs code; instructions needs instructions.
code, instructions The script, for a code revision.
The task, for an instructions revision.
20000A note on the revision.
500For a code revision, what a run does when a step fails. fail fails the run. ask pauses the run for a person (reason step_check_failed), who retries the step or completes the run with its output. repair hands the run to the agent, which finishes the task and proposes a fixed revision for a person to promote. Defaults to the current revision's, or fail.
fail, ask, repair Response
Created
One revision of an agent: instructions or code. Revisions are append-only.
The agent the revision belongs to.
The user who added the revision. Null once they have deleted their account.
When the revision was added.
The revision's id.
code: the revision is a script. instructions: the revision is a task the agent works through a model.
code, instructions The revision's number within the agent, from 1.
On a proposed fix, the revision the repaired run ran.
The script, on a code revision.
The task, on an instructions revision.
The author's note on the revision.
On a code revision, what a run does when a step fails: fail the run, ask (pause for a person, who retries the step or completes the run), or repair (the agent takes over and proposes a fix).
fail, ask, repair On a proposed fix, when it was promoted to current.
Set when the revision is a fix a repair proposed, which is not current until promoted: waiting to be promoted, superseded (the agent has moved on from the revision it fixes, so it can't be promoted), or promoted.
waiting, superseded, promoted The run the revision came from: on a proposed fix, the run whose repair wrote it; on an agent saved from a run, that run.