---
title: "Trigger Ratification Pass"
method: POST
path: "/api/admin/memory/{user_id}/ratification"
tags: ["v2", "admin", "admin", "memory"]
---

# Trigger Ratification Pass

`POST /api/admin/memory/{user_id}/ratification`

Trigger an on-demand ratification sweep for the user (in isolation).

Forwards to ``Scheduler.execute_ratification_pass_now``. Runs ONLY
the ratification supersession sweep — does NOT run dream pass or
community rebuild. Useful for testing ratification behavior
without the full nightly fan-out.

## Path parameters

- `user_id` string, required — User id or 'me'

## Response `200`

Successful Response

- RatificationResult — Structured outcome of a single ratification pass. Surfaced via the scheduler wrapper so admin / future metrics can read promotion vs. supersession counts without re-scanning Graphiti.
  - `user_id` string, required
  - `started_at` string, date-time, required
  - `completed_at` string, date-time, nullable
  - `examined_count` integer
  - `ratified_count` integer
  - `superseded_count` integer
  - `error` string, nullable
  - `skipped` boolean
  - `skip_reason` string, nullable
  - `per_edge_errors` string[]

## Other responses

- `401` — Authentication required
- `422` — Validation Error

## Changes

- **2026-06-11** `ab66703bd004` — 1 info
  - endpoint added
- **2026-04-30** `8c84efcb3afb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/admin/memory/:user_id/ratification/post.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/revisions/5dc375899754/schema)