---
title: "Upsert the per-scenario Agent Smith sparring config (admin console)."
method: PUT
path: "/smith/config/{scenario}"
tags: ["Dojo"]
---

# Upsert the per-scenario Agent Smith sparring config (admin console).

`PUT /smith/config/{scenario}`

## Request

- Base URL: `https://api.mnemom.ai/v1`
- URL: `https://api.mnemom.ai/v1/smith/config/{scenario}`
- Auth: HTTP bearer

Idempotently upserts the per-scenario sparring config keyed by `scenario_id`. Validates the structured blocks (substrate.provider ∈ providers, evolution.novelty_gate ∈ [0,1], technique_toolbox is string[], reward_function values finite). `updated_by`/`updated_at` are SERVER-set from the principal — the client's values are ignored. Returns the stored row. Admin-only. MNE-819.

## Path parameters

- `scenario` string, required

## Request body

- object: Partial config; omitted blocks fall back to the defaults. Any updated_by/updated_at sent is ignored (server-set).
  - `objective` string
  - `strategic_frame` string
  - `technique_toolbox` string[]
  - `reward_function` object
    - `breach` number
    - `near_miss` number
    - `refused` number
    - `novelty_bonus` number
  - `evolution` object
    - `cadence` string
    - `novelty_gate` number
  - `substrate` object
    - `provider` 'anthropic' | 'openai' | 'google'
    - `model` string

## Response `200`

The stored config.

- object
  - `scenario_id` string, required
  - `objective` string, required: Free-form attacker objective.
  - `strategic_frame` string, required
  - `technique_toolbox` string[], required: Technique slugs/ids the attacker may draw on.
  - `reward_function` object, required
    - `breach` number, required
    - `near_miss` number, required
    - `refused` number, required
    - `novelty_bonus` number, required
  - `evolution` object, required
    - `cadence` string, required: Free-form cadence label.
    - `novelty_gate` number, required: Min novelty [0,1] a candidate must clear to enter the archive.
  - `substrate` object, required
    - `provider` 'anthropic' | 'openai' | 'google', required
    - `model` string, required
  - `updated_at` string, date-time, nullable
  - `updated_by` string, nullable

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `429`: Rate-limit exceeded. The global per-IP limiter (100 requests/minute, applied to every `/v1/*` route) rejected this request. Back off until the window resets — `Retry-After` carries the cooldown in seconds and `X-RateLimit-Reset` the absolute reset time.
- `500`: Server error — request was well-formed but the server failed to fulfill it. Typically a downstream dependency (DB / RPC / external API) returned an unexpected error.

---

[API](https://skmtc.dev/mnemom/apis/mnemom-api.md) · [All operations](https://skmtc.dev/mnemom/apis/mnemom-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mnemom/apis/mnemom-api/revisions/274b7a6ea182?raw)