---
title: "Update Variant Parameters"
method: PUT
path: "/variants/{variant_id}/parameters"
tags: ["Variants"]
---

# Update Variant Parameters

`PUT /variants/{variant_id}/parameters`

Updates the parameters for an app variant.

Args:
    variant_id (str): The ID of the app variant to update.
    payload (UpdateVariantParameterPayload): The payload containing the updated parameters.

Raises:
    HTTPException: If there is an error while trying to update the app variant.

Returns:
    JSONResponse: A JSON response containing the updated app variant parameters.

## Path parameters

- `variant_id` string, required

## Request body

- UpdateVariantParameterPayload
  - `parameters` object, required
  - `commit_message` string, nullable

## Response `200`

Successful Response

- AppVariantRevision
  - `id` string, nullable
  - `variant_id` string, nullable
  - `revision` integer, required
  - `modified_by` string, nullable
  - `config` ConfigDB, required
    - `config_name` string, required
    - `parameters` object
  - `created_at` string, required
  - `commit_message` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-02-13** `72fe88316d15` — 2 breaking, 3 info
  - the response property `modified_by` became optional for the status `200`
  - response property `modified_by` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - …1 more
- **2025-11-05** `e62506c24377` — 1 breaking, 6 info
  - the response's body type changed from no type to `object` for status `200`
  - added the optional property `commit_message` to the response with the `200` status
  - added the optional property `id` to the response with the `200` status
  - added the required property `config` to the response with the `200` status
  - …3 more
- **2025-06-27** `e3e84db47198` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/variants/:variant_id/parameters/put.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/edbcb02ac8b1/schema)