---
title: "Mutate runtime config (dev/test only). 410 when disabled."
method: PUT
path: "/v1/memories/config"
tags: ["Configuration"]
---

# Mutate runtime config (dev/test only). 410 when disabled.

`PUT /v1/memories/config`

Set CORE_RUNTIME_CONFIG_MUTATION_ENABLED=true to enable. Startup-only fields (embedding_provider/model, llm_provider/model) return 400 with a `rejected` array listing the offending fields.

## Request body

- object — Runtime config mutation. See handler for 410 and rejected[] paths.

## Response `200`

Applied changes + config snapshot.

- object — Applied config updates + full post-update snapshot.
  - `applied` string[], required
  - `config` object, required — Runtime config snapshot returned by /health + /config.
    - `agentic_retrieval_enabled` boolean, required
    - `clarification_conflict_threshold` number, required
    - `cross_encoder_enabled` boolean, required
    - `embedding_model` string, required
    - `embedding_provider` string, required
    - `entity_graph_enabled` boolean, required
    - `hybrid_search_enabled` boolean, required
    - `iterative_retrieval_enabled` boolean, required
    - `llm_model` string, required
    - `llm_provider` string, required
    - `max_search_results` number, required
    - `repair_loop_enabled` boolean, required
    - `retrieval_profile` string, required
    - `voyage_document_model` string, required
    - `voyage_query_model` string, required
  - `note` string, required

## Other responses

- `400` — Input validation error OR startup-only fields were supplied.
- `410` — Runtime config mutation is disabled in production.
- `500` — Internal server error
- `502` — Upstream AI provider returned an unrecoverable failure (auth, non-retryable 4xx).
- `503` — Upstream AI provider is rate-limited, quota-exhausted, or returned 5xx; consult `retryable`.

---

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