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-5d883c307659b317ca9a27ffd4e98855210c7030167bc79f4727412266c8e53b.yml
-openapi_spec_hash: 4e5b35c97838082939b19a24d9472ffd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-f09b91ede978d3fd05810d3750fcc837f8baa6430fa1be9208ba3088ecaef7f4.yml
+openapi_spec_hash: 957d1e254f2f5933d0c22f3b310122e9
 config_hash: cde97ef3188581c5f4924c633ec33ddb

src/supermemory/_client.py

@@ -245,6 +245,7 @@ def add(
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
         entity_context: str | Omit = omit,
+        filepath: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         task_type: Literal["memory", "superrag"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -270,6 +271,9 @@ def add(
           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 document. Used by supermemoryfs to store the full
+              path of the file.
+
           metadata: Optional metadata for the document.
 
           task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
@@ -292,6 +296,7 @@ def add(
                     "container_tags": container_tags,
                     "custom_id": custom_id,
                     "entity_context": entity_context,
+                    "filepath": filepath,
                     "metadata": metadata,
                     "task_type": task_type,
                 },
@@ -566,6 +571,7 @@ async def add(
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
         entity_context: str | Omit = omit,
+        filepath: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         task_type: Literal["memory", "superrag"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -591,6 +597,9 @@ async def add(
           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 document. Used by supermemoryfs to store the full
+              path of the file.
+
           metadata: Optional metadata for the document.
 
           task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
@@ -613,6 +622,7 @@ async def add(
                     "container_tags": container_tags,
                     "custom_id": custom_id,
                     "entity_context": entity_context,
+                    "filepath": filepath,
                     "metadata": metadata,
                     "task_type": task_type,
                 },

src/supermemory/resources/documents.py

@@ -66,6 +66,7 @@ def update(
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: str | Omit = omit,
         custom_id: str | Omit = omit,
+        filepath: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         task_type: Literal["memory", "superrag"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -99,6 +100,9 @@ def update(
           custom_id: Optional custom ID of the document. This could be an ID from your database that
               will uniquely identify this document.
 
+          filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
+              by supermemoryfs to map documents to filesystem paths.
+
           metadata: Optional metadata for the document. This is used to store additional information
               about the document. You can use this to store any additional information you
               need about the document. Metadata can be filtered through. Keys must be strings
@@ -126,6 +130,7 @@ def update(
                     "container_tags": container_tags,
                     "content": content,
                     "custom_id": custom_id,
+                    "filepath": filepath,
                     "metadata": metadata,
                     "task_type": task_type,
                 },
@@ -141,6 +146,7 @@ def list(
         self,
         *,
         container_tags: SequenceNotStr[str] | Omit = omit,
+        filepath: str | Omit = omit,
         filters: document_list_params.Filters | Omit = omit,
         include_content: bool | Omit = omit,
         limit: Union[str, float] | Omit = omit,
@@ -162,6 +168,9 @@ def list(
               your user, a project ID, or any other identifier you wish to use to group
               documents.
 
+          filepath: Filter documents by filepath. Exact match for full paths, prefix match if ending
+              with /
+
           filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           include_content: Whether to include the content field in the response. Warning: This can make
@@ -188,6 +197,7 @@ def list(
             body=maybe_transform(
                 {
                     "container_tags": container_tags,
+                    "filepath": filepath,
                     "filters": filters,
                     "include_content": include_content,
                     "limit": limit,
@@ -245,6 +255,7 @@ def add(
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
         entity_context: str | Omit = omit,
+        filepath: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         task_type: Literal["memory", "superrag"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -270,6 +281,9 @@ def add(
           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 document. Used by supermemoryfs to store the full
+              path of the file.
+
           metadata: Optional metadata for the document.
 
           task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
@@ -292,6 +306,7 @@ def add(
                     "container_tags": container_tags,
                     "custom_id": custom_id,
                     "entity_context": entity_context,
+                    "filepath": filepath,
                     "metadata": metadata,
                     "task_type": task_type,
                 },
@@ -310,6 +325,7 @@ def batch_add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        filepath: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         task_type: Literal["memory", "superrag"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -333,6 +349,9 @@ 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.
 
+          filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
+              by supermemoryfs to map documents to filesystem paths.
+
           metadata: Optional metadata for the document. This is used to store additional information
               about the document. You can use this to store any additional information you
               need about the document. Metadata can be filtered through. Keys must be strings
@@ -358,6 +377,7 @@ def batch_add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "filepath": filepath,
                     "metadata": metadata,
                     "task_type": task_type,
                 },
@@ -373,6 +393,7 @@ def delete_bulk(
         self,
         *,
         container_tags: SequenceNotStr[str] | Omit = omit,
+        filepath: str | Omit = omit,
         ids: SequenceNotStr[str] | 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.
@@ -387,6 +408,9 @@ def delete_bulk(
         Args:
           container_tags: Array of container tags - all documents in these containers will be deleted
 
+          filepath: Delete documents matching this filepath. Exact match for full paths, prefix
+              match if ending with /
+
           ids: Array of document IDs to delete (max 100 at once)
 
           extra_headers: Send extra headers
@@ -402,6 +426,7 @@ def delete_bulk(
             body=maybe_transform(
                 {
                     "container_tags": container_tags,
+                    "filepath": filepath,
                     "ids": ids,
                 },
                 document_delete_bulk_params.DocumentDeleteBulkParams,
@@ -470,6 +495,7 @@ def upload_file(
         file: FileTypes,
         container_tag: str | Omit = omit,
         container_tags: str | Omit = omit,
+        filepath: str | Omit = omit,
         file_type: str | Omit = omit,
         metadata: str | Omit = omit,
         mime_type: str | Omit = omit,
@@ -494,6 +520,9 @@ def upload_file(
               '["user_123", "project_123"]') or a single string (e.g., 'user_123'). Single
               strings will be automatically converted to an array.
 
+          filepath: Optional file path for the uploaded file (e.g., '/documents/reports/file.pdf').
+              Used by supermemoryfs to map documents to filesystem paths.
+
           file_type:
               Optional file type override to force specific processing behavior. Valid values:
               text, pdf, tweet, google_doc, google_slide, google_sheet, image, video,
@@ -526,6 +555,7 @@ def upload_file(
                 "file": file,
                 "container_tag": container_tag,
                 "container_tags": container_tags,
+                "filepath": filepath,
                 "file_type": file_type,
                 "metadata": metadata,
                 "mime_type": mime_type,
@@ -577,6 +607,7 @@ async def update(
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: str | Omit = omit,
         custom_id: str | Omit = omit,
+        filepath: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         task_type: Literal["memory", "superrag"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -610,6 +641,9 @@ 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.
 
+          filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
+              by supermemoryfs to map documents to filesystem paths.
+
           metadata: Optional metadata for the document. This is used to store additional information
               about the document. You can use this to store any additional information you
               need about the document. Metadata can be filtered through. Keys must be strings
@@ -637,6 +671,7 @@ async def update(
                     "container_tags": container_tags,
                     "content": content,
                     "custom_id": custom_id,
+                    "filepath": filepath,
                     "metadata": metadata,
                     "task_type": task_type,
                 },
@@ -652,6 +687,7 @@ async def list(
         self,
         *,
         container_tags: SequenceNotStr[str] | Omit = omit,
+        filepath: str | Omit = omit,
         filters: document_list_params.Filters | Omit = omit,
         include_content: bool | Omit = omit,
         limit: Union[str, float] | Omit = omit,
@@ -673,6 +709,9 @@ async def list(
               your user, a project ID, or any other identifier you wish to use to group
               documents.
 
+          filepath: Filter documents by filepath. Exact match for full paths, prefix match if ending
+              with /
+
           filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           include_content: Whether to include the content field in the response. Warning: This can make
@@ -699,6 +738,7 @@ async def list(
             body=await async_maybe_transform(
                 {
                     "container_tags": container_tags,
+                    "filepath": filepath,
                     "filters": filters,
                     "include_content": include_content,
                     "limit": limit,
@@ -756,6 +796,7 @@ async def add(
         container_tags: SequenceNotStr[str] | Omit = omit,
         custom_id: str | Omit = omit,
         entity_context: str | Omit = omit,
+        filepath: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         task_type: Literal["memory", "superrag"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -781,6 +822,9 @@ async def add(
           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 document. Used by supermemoryfs to store the full
+              path of the file.
+
           metadata: Optional metadata for the document.
 
           task_type: Task type: "memory" (default) for full context layer with SuperRAG built in,
@@ -803,6 +847,7 @@ async def add(
                     "container_tags": container_tags,
                     "custom_id": custom_id,
                     "entity_context": entity_context,
+                    "filepath": filepath,
                     "metadata": metadata,
                     "task_type": task_type,
                 },
@@ -821,6 +866,7 @@ async def batch_add(
         container_tag: str | Omit = omit,
         container_tags: SequenceNotStr[str] | Omit = omit,
         content: None | Omit = omit,
+        filepath: str | Omit = omit,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
         task_type: Literal["memory", "superrag"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -844,6 +890,9 @@ 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.
 
+          filepath: Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
+              by supermemoryfs to map documents to filesystem paths.
+
           metadata: Optional metadata for the document. This is used to store additional information
               about the document. You can use this to store any additional information you
               need about the document. Metadata can be filtered through. Keys must be strings
@@ -869,6 +918,7 @@ async def batch_add(
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
+                    "filepath": filepath,
                     "metadata": metadata,
                     "task_type": task_type,
                 },
@@ -884,6 +934,7 @@ async def delete_bulk(
         self,
         *,
         container_tags: SequenceNotStr[str] | Omit = omit,
+        filepath: str | Omit = omit,
         ids: SequenceNotStr[str] | 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.
@@ -898,6 +949,9 @@ async def delete_bulk(
         Args:
           container_tags: Array of container tags - all documents in these containers will be deleted
 
+          filepath: Delete documents matching this filepath. Exact match for full paths, prefix
+              match if ending with /
+
           ids: Array of document IDs to delete (max 100 at once)
 
           extra_headers: Send extra headers
@@ -913,6 +967,7 @@ async def delete_bulk(
             body=await async_maybe_transform(
                 {
                     "container_tags": container_tags,
+                    "filepath": filepath,
                     "ids": ids,
                 },
                 document_delete_bulk_params.DocumentDeleteBulkParams,
@@ -981,6 +1036,7 @@ async def upload_file(
         file: FileTypes,
         container_tag: str | Omit = omit,
         container_tags: str | Omit = omit,
+        filepath: str | Omit = omit,
         file_type: str | Omit = omit,
         metadata: str | Omit = omit,
         mime_type: str | Omit = omit,
@@ -1005,6 +1061,9 @@ 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.
 
+          filepath: Optional file path for the uploaded file (e.g., '/documents/reports/file.pdf').
+              Used by supermemoryfs to map documents to filesystem paths.
+
           file_type:
               Optional file type override to force specific processing behavior. Valid values:
               text, pdf, tweet, google_doc, google_slide, google_sheet, image, video,
@@ -1037,6 +1096,7 @@ async def upload_file(
                 "file": file,
                 "container_tag": container_tag,
                 "container_tags": container_tags,
+                "filepath": filepath,
                 "file_type": file_type,
                 "metadata": metadata,
                 "mime_type": mime_type,