Update agent

Apply a partial update to an existing agent configuration.

Gateway contract

The Node gateway validates the request body via Zod middleware before forwarding to the Python agent service. The agentKey path param and the request body are both validated. Query parameters are ignored by the controller.

Update semantics

Only fields present in the request body are updated. When models is included, the gateway Zod middleware requires at least one model entry and at least one object entry with isReasoning: true.

Permissions

The authenticated user must have can_edit on the agent (typically the owner). Service-account and shareWithOrg transitions follow additional Python business rules.

Success response

Returns a lightweight success envelope only. Use GET /agents/{agentKey} to read the persisted agent after an update.

{
  "name": "Renamed Agent"
}

{
  "message": "Agent updated successfully"
}