Update Experiment

Update mutable fields of an experiment.

Use this tool when the caller wants to rename an experiment or replace its description without changing the experiment identity. The request must include at least one mutable field, and names must remain unique within the authenticated user scope.

When to Use:

• Call this to rename an experiment or replace its description while keeping the same experiment identity.
• Call this after retrieving the experiment when the user wants to refine the stored metadata.

Constraints:

• Only name and description are mutable through this route.
• Names must remain unique within the authenticated user scope.

Notes:

• For agent-facing output, explicitly confirm which fields changed and include the resulting id and name.
• The endpoint returns the updated ContextExperimentModel rather than a status-only wrapper.

Args: experiment_id: Opaque experiment identifier to update. user: Authenticated user resolved from the API key. data: Update payload containing name and/or description. db: Active database session.

Returns: The updated experiment object.

Raises: HTTPException: Raised with 404 when the experiment is not available to the caller, or 409 when the requested new name already exists in the same user scope.