Skip to main content
POST
Revert a saved agent to a version

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

saved_agent_id
string<uuid>
required
version
integer
required

Response

Successful Response

One org-level saved agent as the editor, picker and library render it.

allow_fetch
boolean
required
created_at
string<date-time>
required
current_version
integer
required
description
string | null
required
effort
enum<string>
required

How hard the Agent works on each row.

Named levels rather than raw step counts: the level is the user-facing contract, and what each level buys (step and page budgets) is a product decision the loop maps internally — re-tuning budgets never invalidates stored columns.

Available options:
low,
standard,
high
favorite
boolean
required
icon
string | null
required
id
string<uuid>
required
inputs
AgentInputSchema · object[]
required
model_key
string | null
required
name
string
required
output_schema
EnrichmentOutputFields · object
required

The fields-mode output shape: repeatable named typed fields.

The default is Clay's: one text field named response.

owner_user_id
string | null
required
prompt
AgentPromptTemplate · object
required

A saved agent's prompt: literal text with references between the runs.

The same convention every other stored prompt in the product uses (EnrichmentPromptTemplate for columns, template segments for sequences): identity-keyed segments, so renaming what a reference points at never rewrites the prompt. Structurally parallel to the enrichment template rather than importing it — an agent prompt references INPUTS, an enrichment prompt references COLUMNS, and the import hierarchy keeps the two domains apart.

updated_at
string<date-time>
required
use_business_context
boolean
required
use_row_context
boolean
required
is_template
boolean
default:false
owner_display_name
string | null