feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-8a2f638d23709e5ca31c359b3b82ac806c4f2dbb238ca28ee2afed599b3f7be3.yml
-openapi_spec_hash: 87a76bf487509cec077df5d5679a03de
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-e519a815da9102647222f1f73920926f2d8b63d16995d3687213b604963f5ec5.yml
+openapi_spec_hash: 4de453d3c2fca716f7f645d4c2c8f921
 config_hash: f3eb5ca71172780678106f6d46f15dda

README.md

@@ -130,11 +130,12 @@ from supermemory import Supermemory
 
 client = Supermemory()
 
-response = client.search.memories(
-    q="machine learning concepts",
-    include={},
+response = client.memories.update_memory(
+    container_tag="user_123",
+    new_content="John now prefers light mode",
+    temporal_context={},
 )
-print(response.include)
+print(response.temporal_context)
 ```
 
 ## File uploads

src/supermemory/resources/memories.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, Union
+from typing import Dict, Union, Optional
 
 import httpx
 
@@ -105,7 +105,10 @@ def update_memory(
         new_content: str,
         id: str | Omit = omit,
         content: str | Omit = omit,
+        forget_after: Optional[str] | Omit = omit,
+        forget_reason: Optional[str] | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
+        temporal_context: memory_update_memory_params.TemporalContext | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -128,8 +131,18 @@ def update_memory(
           content: Exact content match of the memory entry to operate on. Use this when you don't
               have the ID.
 
+          forget_after: ISO 8601 datetime string. The memory will be auto-forgotten after this time.
+              Pass null to clear an existing expiry. Omit to inherit from the previous
+              version.
+
+          forget_reason: Optional reason for the scheduled forgetting. Cleared automatically when
+              forgetAfter is set to null.
+
           metadata: Optional metadata. If not provided, inherits from the previous version.
 
+          temporal_context: Structured temporal metadata. Merged into the metadata JSON column. If omitted,
+              existing temporalContext is preserved.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -146,7 +159,10 @@ def update_memory(
                     "new_content": new_content,
                     "id": id,
                     "content": content,
+                    "forget_after": forget_after,
+                    "forget_reason": forget_reason,
                     "metadata": metadata,
+                    "temporal_context": temporal_context,
                 },
                 memory_update_memory_params.MemoryUpdateMemoryParams,
             ),
@@ -238,7 +254,10 @@ async def update_memory(
         new_content: str,
         id: str | Omit = omit,
         content: str | Omit = omit,
+        forget_after: Optional[str] | Omit = omit,
+        forget_reason: Optional[str] | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
+        temporal_context: memory_update_memory_params.TemporalContext | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -261,8 +280,18 @@ async def update_memory(
           content: Exact content match of the memory entry to operate on. Use this when you don't
               have the ID.
 
+          forget_after: ISO 8601 datetime string. The memory will be auto-forgotten after this time.
+              Pass null to clear an existing expiry. Omit to inherit from the previous
+              version.
+
+          forget_reason: Optional reason for the scheduled forgetting. Cleared automatically when
+              forgetAfter is set to null.
+
           metadata: Optional metadata. If not provided, inherits from the previous version.
 
+          temporal_context: Structured temporal metadata. Merged into the metadata JSON column. If omitted,
+              existing temporalContext is preserved.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -279,7 +308,10 @@ async def update_memory(
                     "new_content": new_content,
                     "id": id,
                     "content": content,
+                    "forget_after": forget_after,
+                    "forget_reason": forget_reason,
                     "metadata": metadata,
+                    "temporal_context": temporal_context,
                 },
                 memory_update_memory_params.MemoryUpdateMemoryParams,
             ),

src/supermemory/types/memory_update_memory_params.py

@@ -2,13 +2,13 @@
 
 from __future__ import annotations
 
-from typing import Dict, Union
+from typing import Dict, Union, Optional
 from typing_extensions import Required, Annotated, TypedDict
 
 from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
-__all__ = ["MemoryUpdateMemoryParams"]
+__all__ = ["MemoryUpdateMemoryParams", "TemporalContext"]
 
 
 class MemoryUpdateMemoryParams(TypedDict, total=False):
@@ -27,5 +27,38 @@ class MemoryUpdateMemoryParams(TypedDict, total=False):
     Use this when you don't have the ID.
     """
 
+    forget_after: Annotated[Optional[str], PropertyInfo(alias="forgetAfter")]
+    """ISO 8601 datetime string.
+
+    The memory will be auto-forgotten after this time. Pass null to clear an
+    existing expiry. Omit to inherit from the previous version.
+    """
+
+    forget_reason: Annotated[Optional[str], PropertyInfo(alias="forgetReason")]
+    """Optional reason for the scheduled forgetting.
+
+    Cleared automatically when forgetAfter is set to null.
+    """
+
     metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
     """Optional metadata. If not provided, inherits from the previous version."""
+
+    temporal_context: Annotated[TemporalContext, PropertyInfo(alias="temporalContext")]
+    """Structured temporal metadata.
+
+    Merged into the metadata JSON column. If omitted, existing temporalContext is
+    preserved.
+    """
+
+
+class TemporalContext(TypedDict, total=False):
+    """Structured temporal metadata.
+
+    Merged into the metadata JSON column. If omitted, existing temporalContext is preserved.
+    """
+
+    document_date: Annotated[Optional[str], PropertyInfo(alias="documentDate")]
+    """Date the document was authored"""
+
+    event_date: Annotated[Optional[SequenceNotStr[str]], PropertyInfo(alias="eventDate")]
+    """Dates of events referenced in the memory"""

src/supermemory/types/memory_update_memory_response.py

@@ -18,6 +18,12 @@ class MemoryUpdateMemoryResponse(BaseModel):
     created_at: str = FieldInfo(alias="createdAt")
     """When this memory version was created"""
 
+    forget_after: Optional[str] = FieldInfo(alias="forgetAfter", default=None)
+    """When this memory will be auto-forgotten, or null if no expiry"""
+
+    forget_reason: Optional[str] = FieldInfo(alias="forgetReason", default=None)
+    """Reason for the scheduled forgetting, or null"""
+
     memory: str
     """The content of the new memory version"""
 

tests/api_resources/test_memories.py

@@ -82,7 +82,13 @@ def test_method_update_memory_with_all_params(self, client: Supermemory) -> None
             new_content="John now prefers light mode",
             id="mem_abc123",
             content="John prefers dark mode",
+            forget_after="2026-06-01T00:00:00Z",
+            forget_reason="temporary project deadline",
             metadata={"foo": "string"},
+            temporal_context={
+                "document_date": "documentDate",
+                "event_date": ["string"],
+            },
         )
         assert_matches_type(MemoryUpdateMemoryResponse, memory, path=["response"])
 
@@ -182,7 +188,13 @@ async def test_method_update_memory_with_all_params(self, async_client: AsyncSup
             new_content="John now prefers light mode",
             id="mem_abc123",
             content="John prefers dark mode",
+            forget_after="2026-06-01T00:00:00Z",
+            forget_reason="temporary project deadline",
             metadata={"foo": "string"},
+            temporal_context={
+                "document_date": "documentDate",
+                "event_date": ["string"],
+            },
         )
         assert_matches_type(MemoryUpdateMemoryResponse, memory, path=["response"])