agents
Refine Agent Instructions
Suggest ONE new instruction line, with verbatim receipts. Never a rewrite.
Two callers: an 'Every draft' scoped founder note (body.note set — a declared command, converted directly), or the editor's 'Suggest an improvement' button (empty body — reads the recent feedback ledger for the current instructions version). The write itself always happens via the versioned agent update.
post/api/v1/agents/{agent_id}/refine
Path parameters
agent_idstring uuid required
Headers
authorizationstring nullable
Bearer <token>
Bearer <token>
Request body
Response
Successful Response
Changes
No recorded changes to this endpoint across all 1 revision of this API.