Skip to main content
POST
Suggest a revised agent prompt from a natural-language change, streaming the work

Authorizations

Authorization
string
header
required

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

Body

application/json

A natural-language change to make to an existing agent prompt.

current_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.

instruction
string
required
Required string length: 1 - 4000
inputs
AgentInputSchema · object[]
Maximum array length: 20

Response

A stream of Server-Sent Events; the final result frame's data is the revised prompt.

The revised prompt and a one-line account of what changed.