Skip to main content
POST
Propose better prompts from the agent's feedback

Authorizations

X-API-Key
string
header
required

Path Parameters

agent_id
string<uuid>
required

Body

application/json

Ask for a rewrite of the agent's prompts from its feedback.

also_slots
string[] | null

Teach the same feedback to these prompts too, even though none was given on their messages. Feedback names the one message it was given on, so without this a note on the opener can only ever change the opener. Each prompt is still rewritten against its own wording.

revision_request
string
default:""

What to change about a proposal already seen.

Maximum string length: 2000
slot_keys
string[] | null

Only rewrite these prompts; every prompt that has feedback when null.

Response

Successful Response

A proposed rewrite of the agent's prompts, tied to the version it was written against.

agent_id
string<uuid>
required
base_version
integer
required
feedback_count
integer
required
feedback_ids
string<uuid>[]
required
items
OutboundPromptProposalItemReadSchema · object[]
required
feedback_cutoff
string<date-time> | null