---
title: "Patch Memory"
method: PATCH
path: "/admin/api/v1/memory"
tags: ["Agent Configuration"]
---

# Patch Memory

`PATCH /admin/api/v1/memory`

Upsert the singleton memory row.

First write requires both ``agentFramework`` and ``memory``.
Updates apply only the fields explicitly present in the body.
The reload pipeline reassembles + validates the engine config; a
framework/memory mismatch rolls back with a 422.

## Request body

- StandaloneMemoryPatch — Body for PATCH /admin/api/v1/memory. All fields optional.
  - `agentFramework` 'LANGGRAPH' | 'ADK' | 'CREWAI' | 'CUSTOM' | 'TRANSLATION_AGENT' | 'CORRECTION_AGENT' | 'DEEP_RESEARCH_AGENT' — Supported agent frameworks for engine.
  - `memory` union
    - SqliteCheckpointConfig — Configuration for SQLite checkpointer.
      - `type` 'sqlite', required
      - `db_url` string, required
    - InMemoryCheckpointConfig — Configuration for In-Memory checkpointer.
      - `type` 'memory', required
    - PostgresCheckpointConfig — Configuration for Postgres checkpointer.
      - `type` 'postgres', required
      - `db_url` string, required
    - union
      - AdkInMemorySessionConfig — Configuration for In-Memory Session Service.
        - `type` 'in_memory'
      - AdkVertexAiSessionConfig — Configuration for Vertex AI Session Service.
        - `type` 'vertex_ai'
        - `project_id` string, required — Google Cloud Project ID
        - `location` string, required — Google Cloud Location (e.g. us-central1)
        - `reasoning_engine_app_name` string, required — Reasoning Engine Application Name or ID
      - AdkDatabaseSessionConfig — Configuration for Database Session Service.
        - `type` 'database'
        - `db_url` string, required — Database URL (e.g. postgresql+psycopg://...)

## Response `200`

Successful Response

- StandaloneMutationResponseStandaloneMemoryRead
  - `data` StandaloneMemoryRead, required — GET response and the data payload of PATCH responses.
    - `agentFramework` 'LANGGRAPH' | 'ADK' | 'CREWAI' | 'CUSTOM' | 'TRANSLATION_AGENT' | 'CORRECTION_AGENT' | 'DEEP_RESEARCH_AGENT', required — Supported agent frameworks for engine.
    - `memory` union, required
      - SqliteCheckpointConfig — Configuration for SQLite checkpointer.
        - `type` 'sqlite', required
        - `db_url` string, required
      - InMemoryCheckpointConfig — Configuration for In-Memory checkpointer.
        - `type` 'memory', required
      - PostgresCheckpointConfig — Configuration for Postgres checkpointer.
        - `type` 'postgres', required
        - `db_url` string, required
      - union
        - AdkInMemorySessionConfig — Configuration for In-Memory Session Service.
          - `type` 'in_memory'
        - AdkVertexAiSessionConfig — Configuration for Vertex AI Session Service.
          - `type` 'vertex_ai'
          - `project_id` string, required — Google Cloud Project ID
          - `location` string, required — Google Cloud Location (e.g. us-central1)
          - `reasoning_engine_app_name` string, required — Reasoning Engine Application Name or ID
        - AdkDatabaseSessionConfig — Configuration for Database Session Service.
          - `type` 'database'
          - `db_url` string, required — Database URL (e.g. postgresql+psycopg://...)
    - `updatedAt` string, date-time, required
  - `reload` StandaloneReloadResult, required — Reload outcome attached to every admin mutation response. ``reloaded`` means DB committed and runtime now uses the new config. ``restart_required`` means DB committed and process restart is needed. ``reload_failed`` means DB rolled back and runtime is unchanged.
    - `status` 'reloaded' | 'restart_required' | 'reload_failed', required — Outcome of a reload triggered by an admin mutation.
    - `message` string, required
    - `error` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/idun-group/apis/idun-agent-engine-server.md) · [All operations](https://skmtc.net/idun-group/apis/idun-agent-engine-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/idun-group/idun-agent-engine-server/versions/8909cd73cc1c/schema)