Retract a decision (mark as no longer valid).
Send Authorization: Bearer <token>. The token is either a Clerk session JWT or a SmartMemory API key (prefix sm_live_, sm_test_, or legacy sk_).
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request to retract a decision.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/memory/decisions/string/retract" \ -H "Content-Type: application/json" \ -d '{ "reason": "string" }'null{
"detail": {
"code": "invalid_scoped_validity",
"message": "string",
"retryable": false
}
}{
"detail": {
"code": "invalid_scoped_validity",
"message": "string",
"retryable": false
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}{
"detail": {
"code": "invalid_scoped_validity",
"message": "string",
"retryable": false
}
}Retire Ontology Type
Retire a workspace's own confirmed record class. Scope of this surface is deliberately narrow: `layer == "private"` AND `kind == "record"`, even though core's `retire_type` is kind-agnostic. Core resolves an identifier across the private -> domain -> public layers, so an unguarded route would let any authenticated caller retire an effective PUBLIC or pack class: retiring `decision` would disable a built-in memory type for the whole workspace, from a route whose stated job is retiring the workspace's own declared classes. Contract `record_lifecycle.retire_surface` authorizes confirmed PRIVATE record classes and nothing wider. Entity classes keep the curation queue (reject) as their review action. Widening this surface is a deliberate decision, not a default.
Retrieve Archive
Retrieve a previously stored archive artifact by URI.