{ "components": { "securitySchemes": { "BearerAuth": { "bearerFormat": "Memside API key", "scheme": "bearer", "type": "http" } } }, "info": { "description": "Stable API-key operations for portable memory and context. Secret resources and signed-in-user review actions are excluded.", "title": "Memside Public API", "version": "0.2.0" }, "openapi": "3.1.0", "paths": { "/context/resume": { "get": { "operationId": "contextResume", "parameters": [ { "description": "Checkpoint-compatible memory id to build the resume packet from. It does not infer project/workspace scope. When omitted, scope_ref is required and the latest active scoped checkpoint is used.", "in": "query", "name": "checkpoint_id", "required": false, "schema": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Checkpoint-compatible memory id to build the resume packet from. It does not infer project/workspace scope. When omitted, scope_ref is required and the latest active scoped checkpoint is used.", "title": "Checkpoint Id" } }, { "description": "Explicit scope level for rule resolution. Pass it with scope_ref whenever the scope is known, including when checkpoint_id is supplied.", "in": "query", "name": "scope_level", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Explicit scope level for rule resolution. Pass it with scope_ref whenever the scope is known, including when checkpoint_id is supplied.", "title": "Scope Level" } }, { "description": "Exact project/workspace scope reference. Pass it with scope_level whenever known so scoped Operating Rules are included.", "in": "query", "name": "scope_ref", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Exact project/workspace scope reference. Pass it with scope_level whenever known so scoped Operating Rules are included.", "title": "Scope Ref" } }, { "description": "Optional current conversation mode such as development or planning.", "in": "query", "name": "mode", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional current conversation mode such as development or planning.", "title": "Mode" } }, { "description": "Optional explicit User AI Profile. When omitted, the enabled default profile is used.", "in": "query", "name": "profile_id", "required": false, "schema": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Optional explicit User AI Profile. When omitted, the enabled default profile is used.", "title": "Profile Id" } }, { "description": "Context budget mode: auto, light, standard, expanded, or deep.", "in": "query", "name": "budget_mode", "required": false, "schema": { "default": "auto", "description": "Context budget mode: auto, light, standard, expanded, or deep.", "title": "Budget Mode", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "capture_nudge": { "anyOf": [ { "additionalProperties": false, "properties": { "message": { "title": "Message", "type": "string" }, "reason": { "title": "Reason", "type": "string" } }, "required": [ "reason", "message" ], "title": "PublicCaptureNudge", "type": "object" }, { "type": "null" } ], "default": null }, "checkpoint_summary": { "additionalProperties": false, "properties": { "current_priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Current Priority" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "key_references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Key References" }, "next_action": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Hint" }, "needs_user_confirmation": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Needs User Confirmation" }, "priority": { "anyOf": [ { "type": "number" }, { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "suggested_actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Actor" }, "suggested_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Prompt" } }, "title": "PublicNextAction", "type": "object" }, { "type": "null" } ], "default": null }, "occurred_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Occurred At" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "resume_instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resume Instructions" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title" ], "title": "PublicCheckpointSummary", "type": "object" }, "key_decisions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Key Decisions" }, "last_context_loaded": { "additionalProperties": false, "properties": { "checkpoint": { "anyOf": [ { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "source": { "title": "Source", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "source" ], "title": "PublicContextReceiptReference", "type": "object" }, { "type": "null" } ], "default": null }, "estimated_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Estimated Tokens" }, "included": { "items": { "type": "string" }, "title": "Included", "type": "array" }, "latest_checkpoint_reference": { "anyOf": [ { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "source": { "title": "Source", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "source" ], "title": "PublicContextReceiptReference", "type": "object" }, { "type": "null" } ], "default": null }, "max_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Max Tokens" }, "memory_previews_count": { "default": 0, "title": "Memory Previews Count", "type": "integer" }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mode" }, "omissions": { "anyOf": [ { "additionalProperties": false, "properties": { "by_kind": { "additionalProperties": { "type": "integer" }, "title": "By Kind", "type": "object" }, "optional": { "default": 0, "title": "Optional", "type": "integer" }, "required": { "default": 0, "title": "Required", "type": "integer" } }, "title": "PublicContextReceiptOmissions", "type": "object" }, { "type": "null" } ], "default": null }, "profile": { "anyOf": [ { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "selection": { "enum": [ "default", "explicit" ], "title": "Selection", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "selection" ], "title": "PublicContextReceiptProfile", "type": "object" }, { "type": "null" } ], "default": null }, "rules_count": { "default": 0, "title": "Rules Count", "type": "integer" }, "scope_level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Level" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "size_label": { "title": "Size Label", "type": "string" }, "summary": { "title": "Summary", "type": "string" }, "truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Truncated" }, "within_budget": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Within Budget" } }, "required": [ "size_label", "summary" ], "title": "PublicLastContextLoaded", "type": "object" }, "latest_checkpoint_reference": { "anyOf": [ { "additionalProperties": false, "properties": { "current_priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Current Priority" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "key_references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Key References" }, "next_action": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Hint" }, "needs_user_confirmation": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Needs User Confirmation" }, "priority": { "anyOf": [ { "type": "number" }, { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "suggested_actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Actor" }, "suggested_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Prompt" } }, "title": "PublicNextAction", "type": "object" }, { "type": "null" } ], "default": null }, "occurred_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Occurred At" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "resume_instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resume Instructions" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title" ], "title": "PublicCheckpointSummary", "type": "object" }, { "type": "null" } ], "default": null }, "meta": { "additionalProperties": false, "properties": { "budget": { "anyOf": [ { "additionalProperties": false, "properties": { "budget_mode": { "title": "Budget Mode", "type": "string" }, "budget_tier": { "title": "Budget Tier", "type": "string" }, "budget_truncated": { "title": "Budget Truncated", "type": "boolean" }, "effective_max_tokens": { "title": "Effective Max Tokens", "type": "integer" }, "estimated_tokens": { "title": "Estimated Tokens", "type": "integer" }, "max_tokens": { "title": "Max Tokens", "type": "integer" }, "omitted_by_kind": { "additionalProperties": { "type": "integer" }, "title": "Omitted By Kind", "type": "object" }, "optional_omitted": { "default": 0, "title": "Optional Omitted", "type": "integer" }, "required_estimated_tokens": { "title": "Required Estimated Tokens", "type": "integer" }, "required_omitted": { "default": 0, "title": "Required Omitted", "type": "integer" }, "within_budget": { "title": "Within Budget", "type": "boolean" } }, "required": [ "max_tokens", "effective_max_tokens", "estimated_tokens", "within_budget", "budget_truncated", "budget_mode", "budget_tier", "required_estimated_tokens" ], "title": "PublicContextBudget", "type": "object" }, { "type": "null" } ], "default": null }, "checkpoint_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Checkpoint Id" }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mode" }, "scope_level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Level" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "truncated": { "default": false, "title": "Truncated", "type": "boolean" } }, "title": "PublicContextMeta", "type": "object" }, "next_action": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Hint" }, "needs_user_confirmation": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Needs User Confirmation" }, "priority": { "anyOf": [ { "type": "number" }, { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "suggested_actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Actor" }, "suggested_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Prompt" } }, "title": "PublicNextAction", "type": "object" }, { "type": "null" } ], "default": null }, "operating_rules": { "items": { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, "title": "Operating Rules", "type": "array" }, "relevant_memories": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason" }, "reason_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason Code" }, "tags": { "items": { "type": "string" }, "title": "Tags", "type": "array" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "type", "title" ], "title": "PublicRelevantMemoryPreview", "type": "object" }, "title": "Relevant Memories", "type": "array" }, "size_label": { "title": "Size Label", "type": "string" }, "unresolved_questions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Unresolved Questions" }, "user_ai_profile_hint": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "title": "Hint", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memories": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "title", "type", "status", "sensitivity" ], "title": "PublicProfileLinkedMemory", "type": "object" }, "title": "Linked Memories", "type": "array" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "selection": { "enum": [ "default", "explicit" ], "title": "Selection", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "selection", "hint" ], "title": "PublicProfileHint", "type": "object" }, { "type": "null" } ], "default": null } }, "required": [ "operating_rules", "checkpoint_summary", "relevant_memories", "meta", "size_label", "last_context_loaded" ], "title": "PublicResumeContext", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Load resume context" } }, "/context/startup": { "get": { "operationId": "contextStartup", "parameters": [ { "description": "Explicit scope level for scoped startup-context resolution.", "in": "query", "name": "scope_level", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Explicit scope level for scoped startup-context resolution.", "title": "Scope Level" } }, { "description": "Project/workspace scope reference used for startup-context resolution.", "in": "query", "name": "scope_ref", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Project/workspace scope reference used for startup-context resolution.", "title": "Scope Ref" } }, { "description": "Optional current conversation mode such as development or planning.", "in": "query", "name": "mode", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional current conversation mode such as development or planning.", "title": "Mode" } }, { "description": "Optional explicit checkpoint anchor.", "in": "query", "name": "checkpoint_id", "required": false, "schema": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Optional explicit checkpoint anchor.", "title": "Checkpoint Id" } }, { "description": "Optional explicit User AI Profile. When omitted, the enabled default profile is used.", "in": "query", "name": "profile_id", "required": false, "schema": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Optional explicit User AI Profile. When omitted, the enabled default profile is used.", "title": "Profile Id" } }, { "description": "Context budget mode: auto, light, standard, expanded, or deep.", "in": "query", "name": "budget_mode", "required": false, "schema": { "default": "auto", "description": "Context budget mode: auto, light, standard, expanded, or deep.", "title": "Budget Mode", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "active_checkpoint_summary": { "anyOf": [ { "additionalProperties": false, "properties": { "current_priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Current Priority" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "key_references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Key References" }, "next_action": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Hint" }, "needs_user_confirmation": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Needs User Confirmation" }, "priority": { "anyOf": [ { "type": "number" }, { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "suggested_actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Actor" }, "suggested_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Prompt" } }, "title": "PublicNextAction", "type": "object" }, { "type": "null" } ], "default": null }, "occurred_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Occurred At" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "resume_instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resume Instructions" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title" ], "title": "PublicCheckpointSummary", "type": "object" }, { "type": "null" } ], "default": null }, "capture_guidance": { "additionalProperties": false, "properties": { "ask_before_writing": { "default": true, "title": "Ask Before Writing", "type": "boolean" }, "checkpoint_rule": { "title": "Checkpoint Rule", "type": "string" }, "preferred_tools": { "additionalProperties": { "type": "string" }, "title": "Preferred Tools", "type": "object" }, "privacy_note": { "title": "Privacy Note", "type": "string" }, "when_to_capture": { "items": { "type": "string" }, "title": "When To Capture", "type": "array" } }, "required": [ "checkpoint_rule", "privacy_note" ], "title": "PublicCaptureGuidance", "type": "object" }, "capture_nudge": { "anyOf": [ { "additionalProperties": false, "properties": { "message": { "title": "Message", "type": "string" }, "reason": { "title": "Reason", "type": "string" } }, "required": [ "reason", "message" ], "title": "PublicCaptureNudge", "type": "object" }, { "type": "null" } ], "default": null }, "last_context_loaded": { "additionalProperties": false, "properties": { "checkpoint": { "anyOf": [ { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "source": { "title": "Source", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "source" ], "title": "PublicContextReceiptReference", "type": "object" }, { "type": "null" } ], "default": null }, "estimated_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Estimated Tokens" }, "included": { "items": { "type": "string" }, "title": "Included", "type": "array" }, "latest_checkpoint_reference": { "anyOf": [ { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "source": { "title": "Source", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "source" ], "title": "PublicContextReceiptReference", "type": "object" }, { "type": "null" } ], "default": null }, "max_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Max Tokens" }, "memory_previews_count": { "default": 0, "title": "Memory Previews Count", "type": "integer" }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mode" }, "omissions": { "anyOf": [ { "additionalProperties": false, "properties": { "by_kind": { "additionalProperties": { "type": "integer" }, "title": "By Kind", "type": "object" }, "optional": { "default": 0, "title": "Optional", "type": "integer" }, "required": { "default": 0, "title": "Required", "type": "integer" } }, "title": "PublicContextReceiptOmissions", "type": "object" }, { "type": "null" } ], "default": null }, "profile": { "anyOf": [ { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "selection": { "enum": [ "default", "explicit" ], "title": "Selection", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "selection" ], "title": "PublicContextReceiptProfile", "type": "object" }, { "type": "null" } ], "default": null }, "rules_count": { "default": 0, "title": "Rules Count", "type": "integer" }, "scope_level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Level" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "size_label": { "title": "Size Label", "type": "string" }, "summary": { "title": "Summary", "type": "string" }, "truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Truncated" }, "within_budget": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Within Budget" } }, "required": [ "size_label", "summary" ], "title": "PublicLastContextLoaded", "type": "object" }, "latest_checkpoint_reference": { "anyOf": [ { "additionalProperties": false, "properties": { "current_priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Current Priority" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "key_references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Key References" }, "next_action": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Hint" }, "needs_user_confirmation": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Needs User Confirmation" }, "priority": { "anyOf": [ { "type": "number" }, { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "suggested_actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Actor" }, "suggested_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Prompt" } }, "title": "PublicNextAction", "type": "object" }, { "type": "null" } ], "default": null }, "occurred_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Occurred At" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "resume_instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resume Instructions" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title" ], "title": "PublicCheckpointSummary", "type": "object" }, { "type": "null" } ], "default": null }, "meta": { "additionalProperties": false, "properties": { "budget": { "anyOf": [ { "additionalProperties": false, "properties": { "budget_mode": { "title": "Budget Mode", "type": "string" }, "budget_tier": { "title": "Budget Tier", "type": "string" }, "budget_truncated": { "title": "Budget Truncated", "type": "boolean" }, "effective_max_tokens": { "title": "Effective Max Tokens", "type": "integer" }, "estimated_tokens": { "title": "Estimated Tokens", "type": "integer" }, "max_tokens": { "title": "Max Tokens", "type": "integer" }, "omitted_by_kind": { "additionalProperties": { "type": "integer" }, "title": "Omitted By Kind", "type": "object" }, "optional_omitted": { "default": 0, "title": "Optional Omitted", "type": "integer" }, "required_estimated_tokens": { "title": "Required Estimated Tokens", "type": "integer" }, "required_omitted": { "default": 0, "title": "Required Omitted", "type": "integer" }, "within_budget": { "title": "Within Budget", "type": "boolean" } }, "required": [ "max_tokens", "effective_max_tokens", "estimated_tokens", "within_budget", "budget_truncated", "budget_mode", "budget_tier", "required_estimated_tokens" ], "title": "PublicContextBudget", "type": "object" }, { "type": "null" } ], "default": null }, "checkpoint_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Checkpoint Id" }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mode" }, "scope_level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Level" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "truncated": { "default": false, "title": "Truncated", "type": "boolean" } }, "title": "PublicContextMeta", "type": "object" }, "operating_rules": { "items": { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, "title": "Operating Rules", "type": "array" }, "relevant_memory_previews": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason" }, "reason_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason Code" }, "tags": { "items": { "type": "string" }, "title": "Tags", "type": "array" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "type", "title" ], "title": "PublicRelevantMemoryPreview", "type": "object" }, "title": "Relevant Memory Previews", "type": "array" }, "size_label": { "title": "Size Label", "type": "string" }, "user_ai_profile_hint": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "title": "Hint", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memories": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "title", "type", "status", "sensitivity" ], "title": "PublicProfileLinkedMemory", "type": "object" }, "title": "Linked Memories", "type": "array" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "selection": { "enum": [ "default", "explicit" ], "title": "Selection", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "selection", "hint" ], "title": "PublicProfileHint", "type": "object" }, { "type": "null" } ], "default": null } }, "required": [ "operating_rules", "capture_guidance", "relevant_memory_previews", "meta", "size_label", "last_context_loaded" ], "title": "PublicStartupContext", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Load startup context" } }, "/context/workspace-profile": { "get": { "operationId": "contextWorkspaceProfile", "parameters": [ { "description": "Project/workspace scope level for the computed profile.", "in": "query", "name": "scope_level", "required": false, "schema": { "default": "project", "description": "Project/workspace scope level for the computed profile.", "title": "Scope Level", "type": "string" } }, { "description": "Project/workspace scope reference for the computed profile.", "in": "query", "name": "scope_ref", "required": true, "schema": { "description": "Project/workspace scope reference for the computed profile.", "title": "Scope Ref", "type": "string" } }, { "description": "Optional current conversation mode such as development or planning.", "in": "query", "name": "mode", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional current conversation mode such as development or planning.", "title": "Mode" } }, { "description": "Optional explicit User AI Profile. When omitted, the enabled default profile is used.", "in": "query", "name": "profile_id", "required": false, "schema": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Optional explicit User AI Profile. When omitted, the enabled default profile is used.", "title": "Profile Id" } }, { "description": "Context budget mode: auto, light, standard, expanded, or deep.", "in": "query", "name": "budget_mode", "required": false, "schema": { "default": "auto", "description": "Context budget mode: auto, light, standard, expanded, or deep.", "title": "Budget Mode", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "context_sources": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "reason": { "title": "Reason", "type": "string" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "type", "id", "title", "reason" ], "title": "PublicContextSource", "type": "object" }, "title": "Context Sources", "type": "array" }, "current_priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Current Priority" }, "current_state": { "anyOf": [ { "additionalProperties": false, "properties": { "current_priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Current Priority" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "key_references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Key References" }, "next_action": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Hint" }, "needs_user_confirmation": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Needs User Confirmation" }, "priority": { "anyOf": [ { "type": "number" }, { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "suggested_actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Actor" }, "suggested_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Prompt" } }, "title": "PublicNextAction", "type": "object" }, { "type": "null" } ], "default": null }, "occurred_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Occurred At" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "resume_instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resume Instructions" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title" ], "title": "PublicCheckpointSummary", "type": "object" }, { "type": "null" } ], "default": null }, "key_decisions": { "items": { "type": "string" }, "title": "Key Decisions", "type": "array" }, "last_context_loaded": { "additionalProperties": false, "properties": { "checkpoint": { "anyOf": [ { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "source": { "title": "Source", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "source" ], "title": "PublicContextReceiptReference", "type": "object" }, { "type": "null" } ], "default": null }, "estimated_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Estimated Tokens" }, "included": { "items": { "type": "string" }, "title": "Included", "type": "array" }, "latest_checkpoint_reference": { "anyOf": [ { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "source": { "title": "Source", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "source" ], "title": "PublicContextReceiptReference", "type": "object" }, { "type": "null" } ], "default": null }, "max_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Max Tokens" }, "memory_previews_count": { "default": 0, "title": "Memory Previews Count", "type": "integer" }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mode" }, "omissions": { "anyOf": [ { "additionalProperties": false, "properties": { "by_kind": { "additionalProperties": { "type": "integer" }, "title": "By Kind", "type": "object" }, "optional": { "default": 0, "title": "Optional", "type": "integer" }, "required": { "default": 0, "title": "Required", "type": "integer" } }, "title": "PublicContextReceiptOmissions", "type": "object" }, { "type": "null" } ], "default": null }, "profile": { "anyOf": [ { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "selection": { "enum": [ "default", "explicit" ], "title": "Selection", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "selection" ], "title": "PublicContextReceiptProfile", "type": "object" }, { "type": "null" } ], "default": null }, "rules_count": { "default": 0, "title": "Rules Count", "type": "integer" }, "scope_level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Level" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "size_label": { "title": "Size Label", "type": "string" }, "summary": { "title": "Summary", "type": "string" }, "truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Truncated" }, "within_budget": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Within Budget" } }, "required": [ "size_label", "summary" ], "title": "PublicLastContextLoaded", "type": "object" }, "latest_checkpoint_reference": { "anyOf": [ { "additionalProperties": false, "properties": { "current_priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Current Priority" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "key_references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Key References" }, "next_action": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Hint" }, "needs_user_confirmation": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Needs User Confirmation" }, "priority": { "anyOf": [ { "type": "number" }, { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "suggested_actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Actor" }, "suggested_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Prompt" } }, "title": "PublicNextAction", "type": "object" }, { "type": "null" } ], "default": null }, "occurred_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Occurred At" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "resume_instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resume Instructions" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title" ], "title": "PublicCheckpointSummary", "type": "object" }, { "type": "null" } ], "default": null }, "meta": { "additionalProperties": false, "properties": { "budget": { "anyOf": [ { "additionalProperties": false, "properties": { "budget_mode": { "title": "Budget Mode", "type": "string" }, "budget_tier": { "title": "Budget Tier", "type": "string" }, "budget_truncated": { "title": "Budget Truncated", "type": "boolean" }, "effective_max_tokens": { "title": "Effective Max Tokens", "type": "integer" }, "estimated_tokens": { "title": "Estimated Tokens", "type": "integer" }, "max_tokens": { "title": "Max Tokens", "type": "integer" }, "omitted_by_kind": { "additionalProperties": { "type": "integer" }, "title": "Omitted By Kind", "type": "object" }, "optional_omitted": { "default": 0, "title": "Optional Omitted", "type": "integer" }, "required_estimated_tokens": { "title": "Required Estimated Tokens", "type": "integer" }, "required_omitted": { "default": 0, "title": "Required Omitted", "type": "integer" }, "within_budget": { "title": "Within Budget", "type": "boolean" } }, "required": [ "max_tokens", "effective_max_tokens", "estimated_tokens", "within_budget", "budget_truncated", "budget_mode", "budget_tier", "required_estimated_tokens" ], "title": "PublicContextBudget", "type": "object" }, { "type": "null" } ], "default": null }, "checkpoint_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Checkpoint Id" }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mode" }, "scope_level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Level" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "truncated": { "default": false, "title": "Truncated", "type": "boolean" } }, "title": "PublicContextMeta", "type": "object" }, "next_action": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Hint" }, "needs_user_confirmation": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Needs User Confirmation" }, "priority": { "anyOf": [ { "type": "number" }, { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "suggested_actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Actor" }, "suggested_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Prompt" } }, "title": "PublicNextAction", "type": "object" }, { "type": "null" } ], "default": null }, "open_questions": { "items": { "type": "string" }, "title": "Open Questions", "type": "array" }, "operating_rules": { "items": { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, "title": "Operating Rules", "type": "array" }, "project": { "additionalProperties": false, "properties": { "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mode" }, "scope_level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Level" }, "scope_ref": { "title": "Scope Ref", "type": "string" } }, "required": [ "scope_ref" ], "title": "PublicWorkspaceProject", "type": "object" }, "purpose": { "title": "Purpose", "type": "string" }, "relevant_memory_previews": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason" }, "reason_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason Code" }, "tags": { "items": { "type": "string" }, "title": "Tags", "type": "array" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "type", "title" ], "title": "PublicRelevantMemoryPreview", "type": "object" }, "title": "Relevant Memory Previews", "type": "array" }, "resume_instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resume Instructions" }, "size_label": { "title": "Size Label", "type": "string" }, "user_ai_profile_hint": { "anyOf": [ { "additionalProperties": false, "properties": { "hint": { "title": "Hint", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memories": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "title", "type", "status", "sensitivity" ], "title": "PublicProfileLinkedMemory", "type": "object" }, "title": "Linked Memories", "type": "array" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "selection": { "enum": [ "default", "explicit" ], "title": "Selection", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "title", "selection", "hint" ], "title": "PublicProfileHint", "type": "object" }, { "type": "null" } ], "default": null } }, "required": [ "project", "purpose", "operating_rules", "relevant_memory_previews", "size_label", "last_context_loaded", "meta" ], "title": "PublicWorkspaceProfile", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Load a computed workspace profile" } }, "/memories": { "get": { "operationId": "memoriesList", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 20, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "sort_by", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "description": "Filter by status: active/completed/archived", "in": "query", "name": "status", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by status: active/completed/archived", "title": "Status" } }, { "in": "query", "name": "type", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "in": "query", "name": "sensitivity", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sensitivity" } }, { "in": "query", "name": "due_before", "required": false, "schema": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "title": "Due Before" } }, { "in": "query", "name": "due_after", "required": false, "schema": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "title": "Due After" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "additionalProperties": false, "properties": { "attachments": { "items": { "additionalProperties": false, "properties": { "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Filename" }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "metadata_available": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Metadata Available" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mime Type" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size" }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size Bytes" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "PublicAttachmentMetadata", "type": "object" }, "title": "Attachments", "type": "array" }, "body": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Body" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "due_date": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Due Date" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "occurred_at": { "format": "date-time", "title": "Occurred At", "type": "string" }, "operating_rule": { "anyOf": [ { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, { "type": "null" } ], "default": null }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Tags" }, "task_state": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "PublicTaskState", "type": "object" }, { "type": "null" } ], "default": null }, "text": { "title": "Text", "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Title" }, "type": { "title": "Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "id", "type", "text", "status", "occurred_at", "created_at", "updated_at", "sensitivity", "version" ], "title": "PublicMemory", "type": "object" }, "type": "array" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "List memories" }, "post": { "operationId": "memoriesCreate", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "due_date": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Due Date" }, "occurred_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Occurred At" }, "operating_rule": { "anyOf": [ { "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "instruction_text": { "maxLength": 4000, "minLength": 1, "title": "Instruction Text", "type": "string" }, "priority": { "default": 100, "maximum": 1000, "minimum": 0, "title": "Priority", "type": "integer" }, "scope_level": { "pattern": "^(global|workspace|project|thread|task)$", "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "maxLength": 255, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "default": "active", "pattern": "^(active|inactive)$", "title": "Status", "type": "string" }, "title": { "maxLength": 200, "minLength": 1, "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level" ], "title": "OperatingRule", "type": "object" }, { "type": "null" } ], "default": null }, "sensitivity": { "default": "private", "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "default": "active", "enum": [ "active", "archived", "completed" ], "title": "Status", "type": "string" }, "subtasks": { "anyOf": [ { "items": { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "goal": { "maxLength": 2000, "minLength": 1, "title": "Goal", "type": "string" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 3, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "priority": { "anyOf": [ { "enum": [ "low", "normal", "high", "critical" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" } }, "required": [ "goal" ], "title": "PublicSubtaskCreate", "type": "object" }, "maxItems": 10, "type": "array" }, { "type": "null" } ], "default": null, "title": "Subtasks" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Tags" }, "task_state": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "format": "uuid", "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "maxLength": 2000, "minLength": 1, "title": "Goal", "type": "string" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 3, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "maxLength": 2000, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "enum": [ "low", "normal", "high", "critical" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "maximum": 1.0, "minimum": 0.0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "maxLength": 2000, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "format": "uuid", "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "enum": [ "todo", "active", "paused", "blocked", "review", "completed", "failed" ], "title": "Status", "type": "string" } }, "required": [ "goal", "status" ], "title": "PublicTaskStateCreate", "type": "object" }, { "type": "null" } ], "default": null }, "text": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Text" }, "type": { "enum": [ "note", "task", "event", "shopping-list", "wishlist", "prompt", "idea", "goal", "log", "operating_rule" ], "title": "Type", "type": "string" } }, "required": [ "type" ], "title": "PublicMemoryCreate", "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "attachments": { "items": { "additionalProperties": false, "properties": { "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Filename" }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "metadata_available": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Metadata Available" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mime Type" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size" }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size Bytes" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "PublicAttachmentMetadata", "type": "object" }, "title": "Attachments", "type": "array" }, "body": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Body" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "due_date": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Due Date" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "occurred_at": { "format": "date-time", "title": "Occurred At", "type": "string" }, "operating_rule": { "anyOf": [ { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, { "type": "null" } ], "default": null }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Tags" }, "task_state": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "PublicTaskState", "type": "object" }, { "type": "null" } ], "default": null }, "text": { "title": "Text", "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Title" }, "type": { "title": "Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "id", "type", "text", "status", "occurred_at", "created_at", "updated_at", "sensitivity", "version" ], "title": "PublicMemory", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Create a memory" } }, "/memories/batch": { "get": { "operationId": "memoriesGetBatch", "parameters": [ { "description": "Repeat this query parameter for 1-8 exact known Memory IDs.", "in": "query", "name": "memory_ids", "required": true, "schema": { "description": "Repeat this query parameter for 1-8 exact known Memory IDs.", "items": { "type": "string" }, "title": "Memory Ids", "type": "array" } }, { "description": "Include safe attachment metadata only; raw attachment data is never returned.", "in": "query", "name": "include_attachments", "required": false, "schema": { "default": false, "description": "Include safe attachment metadata only; raw attachment data is never returned.", "title": "Include Attachments", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "count": { "title": "Count", "type": "integer" }, "error_count": { "title": "Error Count", "type": "integer" }, "items": { "items": { "anyOf": [ { "additionalProperties": false, "properties": { "attachments": { "items": { "additionalProperties": false, "properties": { "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Filename" }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "metadata_available": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Metadata Available" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mime Type" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size" }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size Bytes" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "PublicAttachmentMetadata", "type": "object" }, "title": "Attachments", "type": "array" }, "due_date": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Due Date" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "occurred_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Occurred At" }, "ok": { "const": true, "title": "Ok", "type": "boolean" }, "operating_rule": { "anyOf": [ { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, { "type": "null" } ], "default": null }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "tags": { "items": { "type": "string" }, "title": "Tags", "type": "array" }, "task_state": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "PublicTaskState", "type": "object" }, { "type": "null" } ], "default": null }, "text": { "title": "Text", "type": "string" }, "type": { "title": "Type", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "ok", "id", "text", "type", "status", "sensitivity", "version" ], "title": "PublicMemoryBatchSuccess", "type": "object" }, { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "message": { "title": "Message", "type": "string" }, "retryable": { "default": false, "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status" ], "title": "PublicBatchItemError", "type": "object" }, "ok": { "const": false, "title": "Ok", "type": "boolean" }, "requested_id": { "title": "Requested Id", "type": "string" } }, "required": [ "ok", "requested_id", "error" ], "title": "PublicMemoryBatchFailure", "type": "object" } ] }, "title": "Items", "type": "array" }, "ok": { "const": true, "default": true, "title": "Ok", "type": "boolean" }, "success_count": { "title": "Success Count", "type": "integer" }, "total_body_chars": { "title": "Total Body Chars", "type": "integer" }, "unique_requested_count": { "title": "Unique Requested Count", "type": "integer" } }, "required": [ "items", "count", "unique_requested_count", "success_count", "error_count", "total_body_chars" ], "title": "PublicMemoryBatchResult", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Read a bounded set of exact memory IDs" } }, "/memories/search": { "get": { "operationId": "memoriesSearch", "parameters": [ { "description": "Search query", "in": "query", "name": "q", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Search query", "title": "Q" } }, { "description": "Tags to filter by", "in": "query", "name": "tags", "required": false, "schema": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Tags to filter by", "title": "Tags" } }, { "description": "Match any tag (OR) instead of all (AND)", "in": "query", "name": "match_any", "required": false, "schema": { "default": false, "description": "Match any tag (OR) instead of all (AND)", "title": "Match Any", "type": "boolean" } }, { "description": "Memory type", "in": "query", "name": "type", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Memory type", "title": "Type" } }, { "description": "Memory status", "in": "query", "name": "status", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Memory status", "title": "Status" } }, { "description": "Memory sensitivity", "in": "query", "name": "sensitivity", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Memory sensitivity", "title": "Sensitivity" } }, { "description": "Start date (inclusive, based on occurred_at)", "in": "query", "name": "date_from", "required": false, "schema": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "description": "Start date (inclusive, based on occurred_at)", "title": "Date From" } }, { "description": "End date (inclusive, based on occurred_at)", "in": "query", "name": "date_to", "required": false, "schema": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "description": "End date (inclusive, based on occurred_at)", "title": "Date To" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "title": "Limit", "type": "integer" } }, { "description": "Sort key (e.g., date_desc). Confidence sort removed.", "in": "query", "name": "sort_by", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Sort key (e.g., date_desc). Confidence sort removed.", "title": "Sort By" } }, { "description": "Filter to memories with/without task_state", "in": "query", "name": "has_task_state", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Filter to memories with/without task_state", "title": "Has Task State" } }, { "description": "Filter by task_state.status", "in": "query", "name": "task_status", "required": false, "schema": { "anyOf": [ { "pattern": "^(todo|active|paused|blocked|review|completed|failed)$", "type": "string" }, { "type": "null" } ], "description": "Filter by task_state.status", "title": "Task Status" } }, { "description": "Filter by task_state.priority", "in": "query", "name": "task_priority", "required": false, "schema": { "anyOf": [ { "pattern": "^(low|normal|high|critical)$", "type": "string" }, { "type": "null" } ], "description": "Filter by task_state.priority", "title": "Task Priority" } }, { "description": "Filter by task_state.assigned_to", "in": "query", "name": "task_assigned_to", "required": false, "schema": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ], "description": "Filter by task_state.assigned_to", "title": "Task Assigned To" } }, { "description": "Return direct subtasks of this task Memory ID.", "in": "query", "name": "parent_id", "required": false, "schema": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "description": "Return direct subtasks of this task Memory ID.", "title": "Parent Id" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "additionalProperties": false, "properties": { "attachments": { "items": { "additionalProperties": false, "properties": { "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Filename" }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "metadata_available": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Metadata Available" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mime Type" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size" }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size Bytes" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "PublicAttachmentMetadata", "type": "object" }, "title": "Attachments", "type": "array" }, "body": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Body" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "due_date": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Due Date" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "occurred_at": { "format": "date-time", "title": "Occurred At", "type": "string" }, "operating_rule": { "anyOf": [ { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, { "type": "null" } ], "default": null }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Tags" }, "task_state": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "PublicTaskState", "type": "object" }, { "type": "null" } ], "default": null }, "text": { "title": "Text", "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Title" }, "type": { "title": "Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "id", "type", "text", "status", "occurred_at", "created_at", "updated_at", "sensitivity", "version" ], "title": "PublicMemory", "type": "object" }, "type": "array" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Search memories" } }, "/memories/{mem_id}": { "delete": { "operationId": "memoriesDelete", "parameters": [ { "in": "path", "name": "mem_id", "required": true, "schema": { "format": "uuid", "title": "Mem Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "delete_confirmation": { "minLength": 1, "title": "Delete Confirmation", "type": "string" } }, "required": [ "delete_confirmation" ], "title": "PublicDeleteRequest", "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deleted": { "const": true, "default": true, "title": "Deleted", "type": "boolean" }, "id": { "format": "uuid", "title": "Id", "type": "string" } }, "required": [ "id" ], "title": "PublicMemoryDeleteResult", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Delete one memory with explicit confirmation" }, "get": { "operationId": "memoriesGet", "parameters": [ { "in": "path", "name": "mem_id", "required": true, "schema": { "format": "uuid", "title": "Mem Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "attachments": { "items": { "additionalProperties": false, "properties": { "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Filename" }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "metadata_available": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Metadata Available" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mime Type" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size" }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size Bytes" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "PublicAttachmentMetadata", "type": "object" }, "title": "Attachments", "type": "array" }, "body": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Body" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "due_date": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Due Date" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "occurred_at": { "format": "date-time", "title": "Occurred At", "type": "string" }, "operating_rule": { "anyOf": [ { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, { "type": "null" } ], "default": null }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Tags" }, "task_state": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "PublicTaskState", "type": "object" }, { "type": "null" } ], "default": null }, "text": { "title": "Text", "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Title" }, "type": { "title": "Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "id", "type", "text", "status", "occurred_at", "created_at", "updated_at", "sensitivity", "version" ], "title": "PublicMemory", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Get one memory" }, "patch": { "operationId": "memoriesUpdate", "parameters": [ { "description": "Memory UUID", "in": "path", "name": "mem_id", "required": true, "schema": { "description": "Memory UUID", "title": "Mem Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "due_date": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Due Date" }, "expected_version": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Expected Version" }, "occurred_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Occurred At" }, "operating_rule": { "anyOf": [ { "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "instruction_text": { "maxLength": 4000, "minLength": 1, "title": "Instruction Text", "type": "string" }, "priority": { "default": 100, "maximum": 1000, "minimum": 0, "title": "Priority", "type": "integer" }, "scope_level": { "pattern": "^(global|workspace|project|thread|task)$", "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "maxLength": 255, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "default": "active", "pattern": "^(active|inactive)$", "title": "Status", "type": "string" }, "title": { "maxLength": 200, "minLength": 1, "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level" ], "title": "OperatingRule", "type": "object" }, { "type": "null" } ], "default": null }, "sensitivity": { "anyOf": [ { "enum": [ "public", "private" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Sensitivity" }, "status": { "anyOf": [ { "enum": [ "active", "archived", "completed" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Tags" }, "task_changes": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "format": "uuid", "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "anyOf": [ { "maxLength": 2000, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 3, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "maxLength": 2000, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "enum": [ "low", "normal", "high", "critical" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "maximum": 1.0, "minimum": 0.0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "maxLength": 2000, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "format": "uuid", "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "anyOf": [ { "enum": [ "todo", "active", "paused", "blocked", "review", "completed", "failed" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "PublicTaskStatePatch", "type": "object" }, { "type": "null" } ], "default": null }, "task_state": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "format": "uuid", "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "maxLength": 2000, "minLength": 1, "title": "Goal", "type": "string" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 3, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "maxLength": 2000, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "enum": [ "low", "normal", "high", "critical" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "maximum": 1.0, "minimum": 0.0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "maxLength": 2000, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "format": "uuid", "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "enum": [ "todo", "active", "paused", "blocked", "review", "completed", "failed" ], "title": "Status", "type": "string" } }, "required": [ "goal", "status" ], "title": "PublicTaskStateCreate", "type": "object" }, { "type": "null" } ], "default": null }, "text": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Text" }, "type": { "anyOf": [ { "enum": [ "note", "task", "event", "shopping-list", "wishlist", "prompt", "idea", "goal", "log", "operating_rule" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "PublicMemoryUpdate", "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "attachments": { "items": { "additionalProperties": false, "properties": { "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Filename" }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "metadata_available": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Metadata Available" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mime Type" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size" }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size Bytes" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "PublicAttachmentMetadata", "type": "object" }, "title": "Attachments", "type": "array" }, "body": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Body" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "due_date": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Due Date" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "occurred_at": { "format": "date-time", "title": "Occurred At", "type": "string" }, "operating_rule": { "anyOf": [ { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, { "type": "null" } ], "default": null }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Tags" }, "task_state": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "PublicTaskState", "type": "object" }, { "type": "null" } ], "default": null }, "text": { "title": "Text", "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Title" }, "type": { "title": "Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "id", "type", "text", "status", "occurred_at", "created_at", "updated_at", "sensitivity", "version" ], "title": "PublicMemory", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Update one memory" } }, "/memories/{mem_id}/context-map": { "get": { "operationId": "memoriesGetContextMap", "parameters": [ { "in": "path", "name": "mem_id", "required": true, "schema": { "format": "uuid", "title": "Mem Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "connected_memories": { "items": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "node_kind": { "enum": [ "source", "linked", "subject_member", "suggested", "checkpoint" ], "title": "Node Kind", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "reason": { "title": "Reason", "type": "string" }, "reason_code": { "title": "Reason Code", "type": "string" }, "relationship_direction": { "anyOf": [ { "enum": [ "outbound", "inbound" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Relationship Direction" }, "relationship_type": { "anyOf": [ { "enum": [ "related_to", "depends_on" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Relationship Type" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "subject_ids": { "items": { "format": "uuid", "type": "string" }, "maxItems": 4, "title": "Subject Ids", "type": "array" }, "tags": { "items": { "type": "string" }, "maxItems": 2, "title": "Tags", "type": "array" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "node_kind", "title", "type", "status", "sensitivity", "reason", "reason_code" ], "title": "PublicContextMapMemoryNode", "type": "object" }, "title": "Connected Memories", "type": "array" }, "facts": { "items": { "additionalProperties": false, "properties": { "fact_text": { "title": "Fact Text", "type": "string" }, "fact_type": { "title": "Fact Type", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "source_memory_id": { "format": "uuid", "title": "Source Memory Id", "type": "string" }, "source_memory_title": { "title": "Source Memory Title", "type": "string" }, "subject_id": { "format": "uuid", "title": "Subject Id", "type": "string" }, "subject_name": { "title": "Subject Name", "type": "string" } }, "required": [ "id", "subject_id", "subject_name", "fact_type", "fact_text", "source_memory_id", "source_memory_title" ], "title": "PublicContextMapFactItem", "type": "object" }, "title": "Facts", "type": "array" }, "links": { "items": { "additionalProperties": false, "properties": { "source_memory_id": { "format": "uuid", "title": "Source Memory Id", "type": "string" }, "source_memory_title": { "title": "Source Memory Title", "type": "string" }, "url": { "title": "Url", "type": "string" } }, "required": [ "url", "source_memory_id", "source_memory_title" ], "title": "PublicContextMapLinkItem", "type": "object" }, "title": "Links", "type": "array" }, "meta": { "additionalProperties": false, "properties": { "fact_limit": { "title": "Fact Limit", "type": "integer" }, "facts_truncated": { "default": false, "title": "Facts Truncated", "type": "boolean" }, "link_limit": { "title": "Link Limit", "type": "integer" }, "links_truncated": { "default": false, "title": "Links Truncated", "type": "boolean" }, "memories_truncated": { "default": false, "title": "Memories Truncated", "type": "boolean" }, "memory_limit": { "title": "Memory Limit", "type": "integer" }, "single_hop": { "const": true, "default": true, "title": "Single Hop", "type": "boolean" }, "subject_limit": { "title": "Subject Limit", "type": "integer" }, "subjects_truncated": { "default": false, "title": "Subjects Truncated", "type": "boolean" } }, "required": [ "memory_limit", "subject_limit", "fact_limit", "link_limit" ], "title": "PublicContextMapMeta", "type": "object" }, "shared_entities": { "items": { "additionalProperties": false, "properties": { "entity_type": { "title": "Entity Type", "type": "string" }, "value": { "title": "Value", "type": "string" } }, "required": [ "entity_type", "value" ], "title": "PublicContextMapEntityItem", "type": "object" }, "title": "Shared Entities", "type": "array" }, "source_memory": { "additionalProperties": false, "properties": { "id": { "format": "uuid", "title": "Id", "type": "string" }, "node_kind": { "enum": [ "source", "linked", "subject_member", "suggested", "checkpoint" ], "title": "Node Kind", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "reason": { "title": "Reason", "type": "string" }, "reason_code": { "title": "Reason Code", "type": "string" }, "relationship_direction": { "anyOf": [ { "enum": [ "outbound", "inbound" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Relationship Direction" }, "relationship_type": { "anyOf": [ { "enum": [ "related_to", "depends_on" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Relationship Type" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "subject_ids": { "items": { "format": "uuid", "type": "string" }, "maxItems": 4, "title": "Subject Ids", "type": "array" }, "tags": { "items": { "type": "string" }, "maxItems": 2, "title": "Tags", "type": "array" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "node_kind", "title", "type", "status", "sensitivity", "reason", "reason_code" ], "title": "PublicContextMapMemoryNode", "type": "object" }, "subjects": { "items": { "additionalProperties": false, "properties": { "active_fact_count": { "minimum": 0, "title": "Active Fact Count", "type": "integer" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_by": { "enum": [ "user", "agent", "system" ], "title": "Linked By", "type": "string" }, "linked_memory_count": { "minimum": 0, "title": "Linked Memory Count", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "reason": { "title": "Reason", "type": "string" }, "subject_type": { "title": "Subject Type", "type": "string" } }, "required": [ "id", "name", "subject_type", "linked_by", "linked_memory_count", "active_fact_count", "reason" ], "title": "PublicContextMapSubjectNode", "type": "object" }, "title": "Subjects", "type": "array" } }, "required": [ "source_memory", "meta" ], "title": "PublicContextMap", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Get a bounded context map" } }, "/memories/{mem_id}/revisions": { "get": { "operationId": "memoriesGetRevisions", "parameters": [ { "in": "path", "name": "mem_id", "required": true, "schema": { "title": "Mem Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "revisions": { "items": { "additionalProperties": false, "properties": { "attachments": { "items": { "additionalProperties": false, "properties": { "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Filename" }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "metadata_available": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Metadata Available" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mime Type" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size" }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Size Bytes" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Type" } }, "title": "PublicAttachmentMetadata", "type": "object" }, "title": "Attachments", "type": "array" }, "body": { "title": "Body", "type": "string" }, "changed_fields": { "items": { "type": "string" }, "title": "Changed Fields", "type": "array" }, "diff_summary": { "default": "", "title": "Diff Summary", "type": "string" }, "operating_rule": { "anyOf": [ { "additionalProperties": false, "properties": { "applies_to_modes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Applies To Modes" }, "id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "instruction_text": { "title": "Instruction Text", "type": "string" }, "instruction_truncated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Instruction Truncated" }, "scope_level": { "title": "Scope Level", "type": "string" }, "scope_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Scope Ref" }, "status": { "title": "Status", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "title", "instruction_text", "scope_level", "status" ], "title": "PublicOperatingRule", "type": "object" }, { "type": "null" } ], "default": null }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "snapshot_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Snapshot At" }, "status": { "title": "Status", "type": "string" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Tags" }, "task_state": { "anyOf": [ { "additionalProperties": false, "properties": { "assigned_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned To" }, "blockers": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Blockers" }, "decisions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Decisions" }, "depends_on": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Depends On" }, "done_when": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Done When" }, "failed_attempts": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Failed Attempts" }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Goal" }, "next_steps": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Next Steps" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "outputs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Outputs" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Id" }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Priority" }, "progress": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "Progress" }, "questions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Questions" }, "references": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "result": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Result" }, "rule_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Rule Ids" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "PublicTaskState", "type": "object" }, { "type": "null" } ], "default": null }, "text": { "title": "Text", "type": "string" }, "text_unavailable": { "default": false, "title": "Text Unavailable", "type": "boolean" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "version", "text", "title", "body", "status", "sensitivity", "type" ], "title": "PublicMemoryRevision", "type": "object" }, "title": "Revisions", "type": "array" } }, "title": "PublicMemoryRevisionList", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "List memory revisions" } }, "/memories/{mem_id}/subjects": { "get": { "operationId": "memoriesListSubjects", "parameters": [ { "in": "path", "name": "mem_id", "required": true, "schema": { "format": "uuid", "title": "Mem Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "additionalProperties": false, "properties": { "aliases": { "items": { "type": "string" }, "title": "Aliases", "type": "array" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "status": { "title": "Status", "type": "string" }, "subject_type": { "title": "Subject Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "name", "subject_type", "status", "created_at", "updated_at" ], "title": "PublicSubject", "type": "object" }, "type": "array" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "List subjects linked to a memory" } }, "/subjects": { "get": { "operationId": "subjectsList", "parameters": [ { "in": "query", "name": "q", "required": false, "schema": { "anyOf": [ { "maxLength": 180, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "in": "query", "name": "subject_type", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subject Type" } }, { "in": "query", "name": "status", "required": false, "schema": { "default": "active", "title": "Status", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "additionalProperties": false, "properties": { "aliases": { "items": { "type": "string" }, "title": "Aliases", "type": "array" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "status": { "title": "Status", "type": "string" }, "subject_type": { "title": "Subject Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "name", "subject_type", "status", "created_at", "updated_at" ], "title": "PublicSubject", "type": "object" }, "type": "array" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "List subjects" }, "post": { "operationId": "subjectsCreate", "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "aliases": { "items": { "type": "string" }, "maxItems": 20, "title": "Aliases", "type": "array" }, "name": { "maxLength": 180, "minLength": 1, "title": "Name", "type": "string" }, "subject_type": { "default": "general", "title": "Subject Type", "type": "string" } }, "required": [ "name" ], "title": "PublicSubjectCreate", "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "aliases": { "items": { "type": "string" }, "title": "Aliases", "type": "array" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "status": { "title": "Status", "type": "string" }, "subject_type": { "title": "Subject Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "name", "subject_type", "status", "created_at", "updated_at" ], "title": "PublicSubject", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Create a subject" } }, "/subjects/{subject_id}": { "delete": { "operationId": "subjectsDelete", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "delete_confirmation": { "minLength": 1, "title": "Delete Confirmation", "type": "string" } }, "required": [ "delete_confirmation" ], "title": "PublicDeleteRequest", "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deleted": { "const": true, "default": true, "title": "Deleted", "type": "boolean" }, "memories_deleted": { "const": false, "default": false, "title": "Memories Deleted", "type": "boolean" }, "subject_id": { "format": "uuid", "title": "Subject Id", "type": "string" } }, "required": [ "subject_id" ], "title": "PublicSubjectDeleteResult", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Delete one subject with explicit confirmation" }, "get": { "operationId": "subjectsGet", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "aliases": { "items": { "type": "string" }, "title": "Aliases", "type": "array" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "status": { "title": "Status", "type": "string" }, "subject_type": { "title": "Subject Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "name", "subject_type", "status", "created_at", "updated_at" ], "title": "PublicSubject", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Get one subject" }, "patch": { "operationId": "subjectsUpdate", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "aliases": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, { "type": "null" } ], "default": null, "title": "Aliases" }, "name": { "anyOf": [ { "maxLength": 180, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Name" }, "status": { "anyOf": [ { "enum": [ "active", "archived" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "subject_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Subject Type" } }, "title": "PublicSubjectUpdate", "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "aliases": { "items": { "type": "string" }, "title": "Aliases", "type": "array" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "status": { "title": "Status", "type": "string" }, "subject_type": { "title": "Subject Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "name", "subject_type", "status", "created_at", "updated_at" ], "title": "PublicSubject", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Update one subject" } }, "/subjects/{subject_id}/context": { "get": { "operationId": "subjectsGetContext", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } }, { "in": "query", "name": "max_memories", "required": false, "schema": { "default": 10, "maximum": 50, "minimum": 1, "title": "Max Memories", "type": "integer" } }, { "in": "query", "name": "max_facts", "required": false, "schema": { "default": 10, "maximum": 50, "minimum": 1, "title": "Max Facts", "type": "integer" } }, { "in": "query", "name": "max_next_actions", "required": false, "schema": { "default": 5, "maximum": 20, "minimum": 1, "title": "Max Next Actions", "type": "integer" } }, { "in": "query", "name": "max_links", "required": false, "schema": { "default": 5, "maximum": 20, "minimum": 1, "title": "Max Links", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "fact_alerts": { "items": { "additionalProperties": false, "properties": { "archived_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Archived At" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "fact_text": { "title": "Fact Text", "type": "string" }, "fact_type": { "enum": [ "preference", "requirement", "constraint", "contact", "decision", "risk", "status", "custom" ], "title": "Fact Type", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "observed_at": { "format": "date-time", "title": "Observed At", "type": "string" }, "reviewed_at": { "format": "date-time", "title": "Reviewed At", "type": "string" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "source": { "additionalProperties": false, "properties": { "created_by_type": { "enum": [ "user", "agent", "system" ], "title": "Created By Type", "type": "string" }, "memory_id": { "format": "uuid", "title": "Memory Id", "type": "string" }, "memory_title": { "title": "Memory Title", "type": "string" }, "memory_version": { "title": "Memory Version", "type": "integer" } }, "required": [ "memory_id", "memory_version", "memory_title", "created_by_type" ], "title": "PublicFactSource", "type": "object" }, "status": { "enum": [ "active", "archived" ], "title": "Status", "type": "string" }, "subject_id": { "format": "uuid", "title": "Subject Id", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "valid_from": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Valid From" }, "valid_to": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Valid To" } }, "required": [ "id", "subject_id", "fact_type", "fact_text", "status", "sensitivity", "source", "observed_at", "reviewed_at", "created_at", "updated_at" ], "title": "PublicSubjectFact", "type": "object" }, "title": "Fact Alerts", "type": "array" }, "facts": { "items": { "additionalProperties": false, "properties": { "archived_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Archived At" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "fact_text": { "title": "Fact Text", "type": "string" }, "fact_type": { "enum": [ "preference", "requirement", "constraint", "contact", "decision", "risk", "status", "custom" ], "title": "Fact Type", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "observed_at": { "format": "date-time", "title": "Observed At", "type": "string" }, "reviewed_at": { "format": "date-time", "title": "Reviewed At", "type": "string" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "source": { "additionalProperties": false, "properties": { "created_by_type": { "enum": [ "user", "agent", "system" ], "title": "Created By Type", "type": "string" }, "memory_id": { "format": "uuid", "title": "Memory Id", "type": "string" }, "memory_title": { "title": "Memory Title", "type": "string" }, "memory_version": { "title": "Memory Version", "type": "integer" } }, "required": [ "memory_id", "memory_version", "memory_title", "created_by_type" ], "title": "PublicFactSource", "type": "object" }, "status": { "enum": [ "active", "archived" ], "title": "Status", "type": "string" }, "subject_id": { "format": "uuid", "title": "Subject Id", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "valid_from": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Valid From" }, "valid_to": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Valid To" } }, "required": [ "id", "subject_id", "fact_type", "fact_text", "status", "sensitivity", "source", "observed_at", "reviewed_at", "created_at", "updated_at" ], "title": "PublicSubjectFact", "type": "object" }, "title": "Facts", "type": "array" }, "facts_truncated": { "default": false, "title": "Facts Truncated", "type": "boolean" }, "important_links": { "items": { "additionalProperties": false, "properties": { "source_memory_id": { "format": "uuid", "title": "Source Memory Id", "type": "string" }, "source_memory_title": { "title": "Source Memory Title", "type": "string" }, "url": { "title": "Url", "type": "string" } }, "required": [ "url", "source_memory_id", "source_memory_title" ], "title": "PublicSubjectImportantLink", "type": "object" }, "title": "Important Links", "type": "array" }, "memories": { "items": { "additionalProperties": false, "properties": { "linked_at": { "format": "date-time", "title": "Linked At", "type": "string" }, "linked_by": { "title": "Linked By", "type": "string" }, "memory_id": { "format": "uuid", "title": "Memory Id", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason" }, "reason_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason Code" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "tags": { "items": { "type": "string" }, "title": "Tags", "type": "array" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "memory_id", "title", "type", "status", "sensitivity", "linked_by", "linked_at" ], "title": "PublicSubjectMemory", "type": "object" }, "title": "Memories", "type": "array" }, "next_actions": { "items": { "additionalProperties": false, "properties": { "due_date": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Due Date" }, "memory_id": { "format": "uuid", "title": "Memory Id", "type": "string" }, "next_action": { "title": "Next Action", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "memory_id", "title", "next_action" ], "title": "PublicSubjectNextAction", "type": "object" }, "title": "Next Actions", "type": "array" }, "pending_suggestion_count": { "default": 0, "title": "Pending Suggestion Count", "type": "integer" }, "returned_count": { "title": "Returned Count", "type": "integer" }, "subject": { "additionalProperties": false, "properties": { "aliases": { "items": { "type": "string" }, "title": "Aliases", "type": "array" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "status": { "title": "Status", "type": "string" }, "subject_type": { "title": "Subject Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "name", "subject_type", "status", "created_at", "updated_at" ], "title": "PublicSubject", "type": "object" }, "truncated": { "default": false, "title": "Truncated", "type": "boolean" } }, "required": [ "subject", "returned_count" ], "title": "PublicSubjectContext", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Get bounded subject context" } }, "/subjects/{subject_id}/deletion/prepare": { "post": { "operationId": "subjectsPrepareDelete", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "linked_memory_count": { "title": "Linked Memory Count", "type": "integer" }, "memories_will_be_deleted": { "const": false, "default": false, "title": "Memories Will Be Deleted", "type": "boolean" }, "message": { "title": "Message", "type": "string" }, "required_confirmation": { "title": "Required Confirmation", "type": "string" }, "subject": { "additionalProperties": false, "properties": { "aliases": { "items": { "type": "string" }, "title": "Aliases", "type": "array" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "linked_memory_count": { "default": 0, "title": "Linked Memory Count", "type": "integer" }, "name": { "title": "Name", "type": "string" }, "status": { "title": "Status", "type": "string" }, "subject_type": { "title": "Subject Type", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "name", "subject_type", "status", "created_at", "updated_at" ], "title": "PublicSubject", "type": "object" } }, "required": [ "subject", "linked_memory_count", "required_confirmation", "message" ], "title": "PublicSubjectDeletionPreview", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Prepare an explicitly confirmed subject deletion" } }, "/subjects/{subject_id}/fact-suggestions": { "post": { "operationId": "subjectsSuggestFact", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "idempotency_key": { "maxLength": 128, "minLength": 1, "title": "Idempotency Key", "type": "string" }, "proposed_fact_text": { "anyOf": [ { "maxLength": 2000, "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Proposed Fact Text" }, "proposed_fact_type": { "anyOf": [ { "enum": [ "preference", "requirement", "constraint", "contact", "decision", "risk", "status", "custom" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Proposed Fact Type" }, "source_memory_id": { "format": "uuid", "title": "Source Memory Id", "type": "string" }, "suggestion_type": { "enum": [ "add_fact", "update_fact" ], "title": "Suggestion Type", "type": "string" }, "target_fact_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Target Fact Id" } }, "required": [ "suggestion_type", "source_memory_id", "idempotency_key" ], "title": "PublicFactSuggestionCreate", "type": "object" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "proposed_fact_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Proposed Fact Text" }, "proposed_fact_type": { "anyOf": [ { "enum": [ "preference", "requirement", "constraint", "contact", "decision", "risk", "status", "custom" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Proposed Fact Type" }, "source": { "additionalProperties": false, "properties": { "memory_id": { "format": "uuid", "title": "Memory Id", "type": "string" }, "memory_title": { "title": "Memory Title", "type": "string" }, "memory_version": { "title": "Memory Version", "type": "integer" } }, "required": [ "memory_id", "memory_version", "memory_title" ], "title": "PublicFactSuggestionSource", "type": "object" }, "status": { "title": "Status", "type": "string" }, "subject_id": { "format": "uuid", "title": "Subject Id", "type": "string" }, "suggestion_type": { "enum": [ "add_fact", "update_fact" ], "title": "Suggestion Type", "type": "string" }, "target_fact_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Target Fact Id" } }, "required": [ "id", "subject_id", "suggestion_type", "source", "status", "created_at" ], "title": "PublicFactSuggestion", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Create a source-backed fact suggestion" } }, "/subjects/{subject_id}/facts": { "get": { "operationId": "subjectsListFacts", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } }, { "in": "query", "name": "include_history", "required": false, "schema": { "default": false, "title": "Include History", "type": "boolean" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "count": { "default": 0, "title": "Count", "type": "integer" }, "items": { "items": { "additionalProperties": false, "properties": { "archived_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Archived At" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "fact_text": { "title": "Fact Text", "type": "string" }, "fact_type": { "enum": [ "preference", "requirement", "constraint", "contact", "decision", "risk", "status", "custom" ], "title": "Fact Type", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "observed_at": { "format": "date-time", "title": "Observed At", "type": "string" }, "reviewed_at": { "format": "date-time", "title": "Reviewed At", "type": "string" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "source": { "additionalProperties": false, "properties": { "created_by_type": { "enum": [ "user", "agent", "system" ], "title": "Created By Type", "type": "string" }, "memory_id": { "format": "uuid", "title": "Memory Id", "type": "string" }, "memory_title": { "title": "Memory Title", "type": "string" }, "memory_version": { "title": "Memory Version", "type": "integer" } }, "required": [ "memory_id", "memory_version", "memory_title", "created_by_type" ], "title": "PublicFactSource", "type": "object" }, "status": { "enum": [ "active", "archived" ], "title": "Status", "type": "string" }, "subject_id": { "format": "uuid", "title": "Subject Id", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "valid_from": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Valid From" }, "valid_to": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Valid To" } }, "required": [ "id", "subject_id", "fact_type", "fact_text", "status", "sensitivity", "source", "observed_at", "reviewed_at", "created_at", "updated_at" ], "title": "PublicSubjectFact", "type": "object" }, "title": "Items", "type": "array" } }, "title": "PublicSubjectFactList", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "List subject facts" } }, "/subjects/{subject_id}/memories": { "get": { "operationId": "subjectsListMemories", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } }, { "in": "query", "name": "include_archived", "required": false, "schema": { "default": false, "title": "Include Archived", "type": "boolean" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 20, "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "additionalProperties": false, "properties": { "linked_at": { "format": "date-time", "title": "Linked At", "type": "string" }, "linked_by": { "title": "Linked By", "type": "string" }, "memory_id": { "format": "uuid", "title": "Memory Id", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason" }, "reason_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason Code" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "tags": { "items": { "type": "string" }, "title": "Tags", "type": "array" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "memory_id", "title", "type", "status", "sensitivity", "linked_by", "linked_at" ], "title": "PublicSubjectMemory", "type": "object" }, "type": "array" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "List memories linked to a subject" }, "post": { "operationId": "subjectsLinkMemory", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "memory_id": { "format": "uuid", "title": "Memory Id", "type": "string" } }, "required": [ "memory_id" ], "title": "PublicSubjectMemoryLinkInput", "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "linked": { "title": "Linked", "type": "boolean" }, "memory": { "additionalProperties": false, "properties": { "linked_at": { "format": "date-time", "title": "Linked At", "type": "string" }, "linked_by": { "title": "Linked By", "type": "string" }, "memory_id": { "format": "uuid", "title": "Memory Id", "type": "string" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Preview Text" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason" }, "reason_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason Code" }, "sensitivity": { "enum": [ "public", "private" ], "title": "Sensitivity", "type": "string" }, "status": { "title": "Status", "type": "string" }, "tags": { "items": { "type": "string" }, "title": "Tags", "type": "array" }, "title": { "title": "Title", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "memory_id", "title", "type", "status", "sensitivity", "linked_by", "linked_at" ], "title": "PublicSubjectMemory", "type": "object" } }, "required": [ "linked", "memory" ], "title": "PublicSubjectMemoryLinkResult", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Link a memory to a subject" } }, "/subjects/{subject_id}/memories/{memory_id}": { "delete": { "operationId": "subjectsUnlinkMemory", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } }, { "in": "path", "name": "memory_id", "required": true, "schema": { "format": "uuid", "title": "Memory Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "removed": { "title": "Removed", "type": "boolean" } }, "required": [ "removed" ], "title": "PublicSubjectMemoryUnlinkResult", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "Unlink a memory from a subject" } }, "/subjects/{subject_id}/memory-insights": { "get": { "operationId": "subjectsListMemoryInsights", "parameters": [ { "in": "path", "name": "subject_id", "required": true, "schema": { "format": "uuid", "title": "Subject Id", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "count": { "default": 0, "title": "Count", "type": "integer" }, "items": { "items": { "additionalProperties": false, "properties": { "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "active_linked_memory_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Active Linked Memory Count" }, "current_source_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Current Source Version" }, "fact_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Fact Id" }, "fact_source_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Fact Source Version" }, "fact_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Fact Type" }, "matching_fact_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Matching Fact Id" }, "source_memory_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Source Memory Id" }, "source_memory_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Source Memory Version" }, "subject_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Subject Id" } }, "title": "PublicMemoryInsightEvidence", "type": "object" }, "fact_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Fact Id" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "insight_type": { "title": "Insight Type", "type": "string" }, "proposed_action": { "title": "Proposed Action", "type": "string" }, "related_fact_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Related Fact Id" }, "source_memory_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Source Memory Id" }, "status": { "const": "pending", "title": "Status", "type": "string" }, "subject_id": { "format": "uuid", "title": "Subject Id", "type": "string" } }, "required": [ "id", "subject_id", "insight_type", "proposed_action", "evidence", "status", "created_at" ], "title": "PublicMemoryInsight", "type": "object" }, "title": "Items", "type": "array" } }, "title": "PublicMemoryInsightList", "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (401)" }, "403": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (403)" }, "404": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (404)" }, "409": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (409)" }, "413": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (413)" }, "422": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (422)" }, "429": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (429)", "headers": { "Retry-After": { "description": "Seconds to wait before retrying", "schema": { "minimum": 1, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (500)" }, "503": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "detail": { "default": null, "title": "Detail" }, "error": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Details" }, "message": { "title": "Message", "type": "string" }, "retryable": { "title": "Retryable", "type": "boolean" }, "status": { "title": "Status", "type": "integer" } }, "required": [ "code", "message", "status", "retryable" ], "title": "PublicError", "type": "object" }, "ok": { "const": false, "default": false, "title": "Ok", "type": "boolean" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Request Id" } }, "required": [ "error" ], "title": "PublicErrorResponse", "type": "object" } } }, "description": "Public API error (503)" } }, "security": [ { "BearerAuth": [] } ], "summary": "List pending read-only memory insights" } } }, "servers": [ { "url": "https://api.memside.com" } ] }