---
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

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/versions/382041c7ecb2/schema)