Skip to content

REST API — Agent overrides

Method Path What it does
GET /api/agent-overrides List the agents available in this workspace, which of their settings the workspace may change, and what it has changed.
DELETE /api/agent-overrides/agents/{agent} Reset this agent to its defaults. The change is kept in history, so it can be restored.
GET /api/agent-overrides/agents/{agent} One agent’s settings in this workspace.
PUT /api/agent-overrides/agents/{agent} Replace this agent’s settings in the workspace. An omitted field goes back to its default.
GET /api/agent-overrides/agents/{agent}/history This agent’s settings history, newest first: what each change replaced and what it set.
POST /api/agent-overrides/agents/{agent}/history/{entry_id}/restore Restore the settings a history entry replaced.
POST /api/agent-overrides/agents/{agent}/test Try settings on one message before saving them. The run is metered; nothing is saved.
GET /api/agent-overrides/presets The presets available in this workspace, and what each one sets.
POST /api/agent-overrides/presets/{preset} Apply a preset to every agent whose model or effort the workspace may change. Each change is recorded in that agent’s history.