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-92296474fc4d680741b695918b87850ffe3655530a4611dadfa599e4376a778e.yml
-openapi_spec_hash: aacf6838b9ec2431611e87fab118d913
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc/supermemory-new-5e1ac142b427e15ca46d0920c4d65c6e1f464e46ce014e42cd5a716f97b820ab.yml
+openapi_spec_hash: f0d9f62796cf1fb5dd79dad7b1c692fd
 config_hash: cde97ef3188581c5f4924c633ec33ddb

src/supermemory/resources/documents.py

@@ -496,6 +496,8 @@ def upload_file(
         file: FileTypes,
         container_tag: str | Omit = omit,
         container_tags: str | Omit = omit,
+        custom_id: str | Omit = omit,
+        entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
         file_type: str | Omit = omit,
         metadata: str | Omit = omit,
@@ -521,6 +523,12 @@ def upload_file(
               '["user_123", "project_123"]') or a single string (e.g., 'user_123'). Single
               strings will be automatically converted to an array.
 
+          custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
+              hyphens, underscores, and colons only.
+
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           filepath: Optional file path for the uploaded file (e.g., '/documents/reports/file.pdf').
               Used by supermemoryfs to map documents to filesystem paths.
 
@@ -556,6 +564,8 @@ def upload_file(
                 "file": file,
                 "container_tag": container_tag,
                 "container_tags": container_tags,
+                "custom_id": custom_id,
+                "entity_context": entity_context,
                 "filepath": filepath,
                 "file_type": file_type,
                 "metadata": metadata,
@@ -1038,6 +1048,8 @@ async def upload_file(
         file: FileTypes,
         container_tag: str | Omit = omit,
         container_tags: str | Omit = omit,
+        custom_id: str | Omit = omit,
+        entity_context: str | Omit = omit,
         filepath: str | Omit = omit,
         file_type: str | Omit = omit,
         metadata: str | Omit = omit,
@@ -1063,6 +1075,12 @@ async def upload_file(
               '["user_123", "project_123"]') or a single string (e.g., 'user_123'). Single
               strings will be automatically converted to an array.
 
+          custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
+              hyphens, underscores, and colons only.
+
+          entity_context: Optional entity context for this container tag. Max 1500 characters. Used during
+              document processing to guide memory extraction.
+
           filepath: Optional file path for the uploaded file (e.g., '/documents/reports/file.pdf').
               Used by supermemoryfs to map documents to filesystem paths.
 
@@ -1098,6 +1116,8 @@ async def upload_file(
                 "file": file,
                 "container_tag": container_tag,
                 "container_tags": container_tags,
+                "custom_id": custom_id,
+                "entity_context": entity_context,
                 "filepath": filepath,
                 "file_type": file_type,
                 "metadata": metadata,

src/supermemory/types/document_upload_file_params.py

@@ -25,6 +25,18 @@ class DocumentUploadFileParams(TypedDict, total=False):
     converted to an array.
     """
 
+    custom_id: Annotated[str, PropertyInfo(alias="customId")]
+    """Optional custom ID of the document.
+
+    Max 100 characters, alphanumeric with hyphens, underscores, and colons only.
+    """
+
+    entity_context: Annotated[str, PropertyInfo(alias="entityContext")]
+    """Optional entity context for this container tag.
+
+    Max 1500 characters. Used during document processing to guide memory extraction.
+    """
+
     filepath: str
     """Optional file path for the uploaded file (e.g., '/documents/reports/file.pdf').
 

tests/api_resources/test_documents.py

@@ -438,6 +438,8 @@ def test_method_upload_file_with_all_params(self, client: Supermemory) -> None:
             file=b"Example data",
             container_tag="user",
             container_tags='["user_123", "project_123"]',
+            custom_id="mem_abc123",
+            entity_context="This user is a software engineer who prefers concise technical documentation.",
             filepath="/documents/reports/file.pdf",
             file_type="image",
             metadata='{"category": "technology", "isPublic": true, "readingTime": 5}',
@@ -891,6 +893,8 @@ async def test_method_upload_file_with_all_params(self, async_client: AsyncSuper
             file=b"Example data",
             container_tag="user",
             container_tags='["user_123", "project_123"]',
+            custom_id="mem_abc123",
+            entity_context="This user is a software engineer who prefers concise technical documentation.",
             filepath="/documents/reports/file.pdf",
             file_type="image",
             metadata='{"category": "technology", "isPublic": true, "readingTime": 5}',