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/supermemory-new-5ad0e09495301abdcb7a5a63738ce5841248518504e122003219230ef35ed439.yml
-openapi_spec_hash: 6462e423d826118caba0292cd5956178
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc/supermemory-new-4bec4aac7a4fd11299c105dd60bc086c0aaf51d5cd0f63075efefa56bc19a67f.yml
+openapi_spec_hash: f87b9769f91d448f4eb797c37ef4d061
 config_hash: cde97ef3188581c5f4924c633ec33ddb

src/supermemory/_client.py

@@ -254,6 +254,7 @@ def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -280,6 +281,12 @@ def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates against this instead of the ingestion time, and documents in a
+              batch are processed oldest-first so newer facts correctly supersede older ones.
+              Set this whenever you backfill historical content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -315,6 +322,7 @@ def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
@@ -611,6 +619,7 @@ async def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -637,6 +646,12 @@ async def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates against this instead of the ingestion time, and documents in a
+              batch are processed oldest-first so newer facts correctly supersede older ones.
+              Set this whenever you backfill historical content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -672,6 +687,7 @@ async def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,

src/supermemory/resources/documents.py

@@ -67,6 +67,7 @@ def update(
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: str | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -102,6 +103,13 @@ def update(
           custom_id: Optional custom ID of the document. This could be an ID from your database that
               will uniquely identify this document.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates ('yesterday', 'last quarter') against this instead of the
+              ingestion time, and documents in a batch are processed oldest-first so newer
+              facts correctly supersede older ones. Set this whenever you backfill historical
+              content.
+
           filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
               by supermemoryfs to map documents to filesystem paths.
 
@@ -137,6 +145,7 @@ def update(
                     "container_tags": container_tags,
                     "content": content,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
                     "metadata": metadata,
@@ -262,6 +271,7 @@ def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -288,6 +298,12 @@ def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates against this instead of the ingestion time, and documents in a
+              batch are processed oldest-first so newer facts correctly supersede older ones.
+              Set this whenever you backfill historical content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -323,6 +339,7 @@ def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
@@ -345,6 +362,7 @@ def batch_add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -372,6 +390,13 @@ def batch_add(
               containerized by. This can be an ID for your user, a project ID, or any other
               identifier you wish to use to group documents.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates ('yesterday', 'last quarter') against this instead of the
+              ingestion time, and documents in a batch are processed oldest-first so newer
+              facts correctly supersede older ones. Set this whenever you backfill historical
+              content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -413,6 +438,7 @@ def batch_add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
@@ -670,6 +696,7 @@ async def update(
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: str | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         filepath: str | Omit = omit,
         filter_by_metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
@@ -705,6 +732,13 @@ async def update(
           custom_id: Optional custom ID of the document. This could be an ID from your database that
               will uniquely identify this document.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates ('yesterday', 'last quarter') against this instead of the
+              ingestion time, and documents in a batch are processed oldest-first so newer
+              facts correctly supersede older ones. Set this whenever you backfill historical
+              content.
+
           filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
               by supermemoryfs to map documents to filesystem paths.
 
@@ -740,6 +774,7 @@ async def update(
                     "container_tags": container_tags,
                     "content": content,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "filepath": filepath,
                     "filter_by_metadata": filter_by_metadata,
                     "metadata": metadata,
@@ -865,6 +900,7 @@ async def add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -891,6 +927,12 @@ async def add(
           custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
               hyphens, underscores, and dots only.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates against this instead of the ingestion time, and documents in a
+              batch are processed oldest-first so newer facts correctly supersede older ones.
+              Set this whenever you backfill historical content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -926,6 +968,7 @@ async def add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "custom_id": custom_id,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,
@@ -948,6 +991,7 @@ async def batch_add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        document_date: str | Omit = omit,
         dreaming: Literal["instant", "dynamic"] | Omit = omit,
         entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
@@ -975,6 +1019,13 @@ async def batch_add(
               containerized by. This can be an ID for your user, a project ID, or any other
               identifier you wish to use to group documents.
 
+          document_date: When this document's content is from, as opposed to when it was uploaded.
+              Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+              relative dates ('yesterday', 'last quarter') against this instead of the
+              ingestion time, and documents in a batch are processed oldest-first so newer
+              facts correctly supersede older ones. Set this whenever you backfill historical
+              content.
+
           dreaming: Processing mode. "dynamic" (default) groups related documents together so
               memories form from coherent, logical units rather than one isolated entry at a
               time. "instant" processes each document on its own right away, and bills one
@@ -1016,6 +1067,7 @@ async def batch_add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "document_date": document_date,
                     "dreaming": dreaming,
                     "entity_context": entity_context,
                     "filepath": filepath,

src/supermemory/types/client_add_params.py

@@ -32,6 +32,15 @@ class ClientAddParams(TypedDict, total=False):
     Max 100 characters, alphanumeric with hyphens, underscores, and dots only.
     """
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates against this instead of the ingestion time, and documents in a
+    batch are processed oldest-first so newer facts correctly supersede older ones.
+    Set this whenever you backfill historical content.
+    """
+
     dreaming: Literal["instant", "dynamic"]
     """Processing mode.
 

src/supermemory/types/document_add_params.py

@@ -32,6 +32,15 @@ class DocumentAddParams(TypedDict, total=False):
     Max 100 characters, alphanumeric with hyphens, underscores, and dots only.
     """
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates against this instead of the ingestion time, and documents in a
+    batch are processed oldest-first so newer facts correctly supersede older ones.
+    Set this whenever you backfill historical content.
+    """
+
     dreaming: Literal["instant", "dynamic"]
     """Processing mode.
 

src/supermemory/types/document_batch_add_params.py

@@ -30,6 +30,16 @@ class DocumentBatchAddParams(TypedDict, total=False):
 
     content: None
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates ('yesterday', 'last quarter') against this instead of the
+    ingestion time, and documents in a batch are processed oldest-first so newer
+    facts correctly supersede older ones. Set this whenever you backfill historical
+    content.
+    """
+
     dreaming: Literal["instant", "dynamic"]
     """Processing mode.
 
@@ -111,6 +121,16 @@ class DocumentsUnionMember0(TypedDict, total=False):
     document.
     """
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates ('yesterday', 'last quarter') against this instead of the
+    ingestion time, and documents in a batch are processed oldest-first so newer
+    facts correctly supersede older ones. Set this whenever you backfill historical
+    content.
+    """
+
     dreaming: Literal["instant", "dynamic"]
     """Processing mode.
 

src/supermemory/types/document_update_params.py

@@ -45,6 +45,16 @@ class DocumentUpdateParams(TypedDict, total=False):
     document.
     """
 
+    document_date: Annotated[str, PropertyInfo(alias="documentDate")]
+    """When this document's content is from, as opposed to when it was uploaded.
+
+    Accepts YYYY-MM-DD or a full ISO 8601 timestamp. Memory extraction resolves
+    relative dates ('yesterday', 'last quarter') against this instead of the
+    ingestion time, and documents in a batch are processed oldest-first so newer
+    facts correctly supersede older ones. Set this whenever you backfill historical
+    content.
+    """
+
     filepath: str
     """Optional file path for the document (e.g., '/documents/reports/file.pdf').
 

tests/api_resources/test_client.py

@@ -33,6 +33,7 @@ def test_method_add_with_all_params(self, client: Supermemory) -> None:
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            document_date="documentDate",
             dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",
@@ -148,6 +149,7 @@ async def test_method_add_with_all_params(self, async_client: AsyncSupermemory)
             container_tag="containerTag",
             container_tags=["string"],
             custom_id="customId",
+            document_date="documentDate",
             dreaming="instant",
             entity_context="entityContext",
             filepath="filepath",