---
title: "Update Config"
method: PUT
path: "/api/v1/config/{key}"
tags: ["config"]
---

# Update Config

`PUT /api/v1/config/{key}`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/config/{key}`
- Auth: none declared

Refuse to update a configuration value (Issue #1580).

Admin-only endpoint, kept so existing clients get a clear answer. Every key
is env-backed: it is set via environment variables and applied on
restart/redeploy, and no runtime consumer reads a stored override.

Args:
    key: Configuration key the caller tried to update
    request: Rejected value
    admin: Authenticated admin user

Raises:
    ConfigReadOnlyError: Always (409 ``CFG-002``)

## Path parameters

- `key` string, required

## Request body

- ConfigUpdateRequest: Update configuration value.
  - `value` unknown, required

## Response `200`

Successful Response

- unknown

## Other responses

- `409`: Always: configuration is read-only (`CFG-002`). Values are set via environment variables and applied on restart/redeploy.
- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/09f17f5ada29?raw)