Skip to main content

Reclassification API

Part of CLPI Phase 2: Card Lifecycle & Trust Recovery. The Reclassification API enables violation reclassification and trust score recovery.
The Reclassification API enables operators to reclassify checkpoint violations as card gaps or behavior gaps, trigger score recomputation, review amendment history, and export full compliance records for audit purposes. All reclassification data feeds into the Trust Rating pipeline and is reflected in the agent’s integrity chain. Base URL: https://api.mnemom.ai/v1

Authentication

All reclassification endpoints require API key authentication. Pass your key in the Authorization header:
API keys can be created in your dashboard under Settings or via POST /v1/api-keys.

Rate limits

Rate-limited responses return HTTP 429 with a Retry-After header.

Endpoints

POST /v1/agents//reclassify

Reclassify a checkpoint violation as card_gap or behavior_gap. Card-gap reclassifications indicate that the agent behaved correctly but the card definition was incomplete. Behavior-gap reclassifications indicate a genuine agent misbehavior that should remain on record. Parameters: Request body:
Response: 200 OK
Response fields: score_impact object: Error responses:

POST /v1/reputation//recompute

Trigger score recomputation after reclassification. Scores are recomputed with card_gap violations excluded from the compliance and drift stability components. Recomputation propagates through the agent’s delegation graph using the configured decay factor. Parameters: Response: 200 OK
Response fields: propagation object: Error responses:

GET /v1/agents//compliance-export

Export the full compliance record for an agent, including all violations, reclassifications, card amendments, and score history. Designed for audit purposes and regulatory compliance workflows. Parameters: Response: 200 OK
Response fields: Error responses:

GET /v1/agents//reclassifications

List reclassification history for an agent. Returns paginated results ordered by creation date (newest first). Parameters: Response: 200 OK
Error responses:

GET /v1/agents//card-amendments

List card amendment history for an agent. Returns paginated results ordered by creation date (newest first). Parameters: Response: 200 OK
Error responses:

Error codes

All error responses follow the standard envelope:

SDK usage

Reclassification, score recomputation, and compliance export are not yet wrapped by the @mnemom/sdk client (which currently covers the agents and catalog namespaces). Call these endpoints directly over HTTP until SDK helpers ship.

See also