mixedbread-ai · stainless-app · Jun 30, 2025 · Jun 30, 2025 · Jun 30, 2025 · Jun 30, 2025
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.14.0"
+  ".": "0.15.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 49
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mixedbread%2Fmixedbread-7361ed078e7c394c7cb1da4a3e2f3417d4498de5eea648cf9d3caaa0ddf85f78.yml
-openapi_spec_hash: 4ae67ffa9040c2d5a87026df79c1feaf
-config_hash: 6098ac28bc4ec5be0c546035a5d81394
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mixedbread%2Fmixedbread-fe968780e87b8a5ff65ea009ade00fb0e27e951f7ce16d39a2ae0957740add45.yml
+openapi_spec_hash: 9a29ae1bb05df2061e321b0d1adef675
+config_hash: e4d40031e9232e8e6c16e73430b7f535
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.15.0 (2025-06-30)
+
+Full Changelog: [v0.14.0...v0.15.0](https://github.com/mixedbread-ai/mixedbread-python/compare/v0.14.0...v0.15.0)
+
+### Features
+
+* **api:** api update ([cff0ed5](https://github.com/mixedbread-ai/mixedbread-python/commit/cff0ed51623d5cf3cecc3f0e93a83414b6177f2b))
+
 ## 0.14.0 (2025-06-30)
 
 Full Changelog: [v0.13.2...v0.14.0](https://github.com/mixedbread-ai/mixedbread-python/compare/v0.13.2...v0.14.0)

diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "mixedbread"
-version = "0.14.0"
+version = "0.15.0"
 description = "The official Python library for the Mixedbread API"
 dynamic = ["readme"]
 license = "Apache-2.0"

diff --git a/src/mixedbread/_version.py b/src/mixedbread/_version.py
@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "mixedbread"
-__version__ = "0.14.0"  # x-release-please-version
+__version__ = "0.15.0"  # x-release-please-version
diff --git a/src/mixedbread/resources/data_sources/connectors.py b/src/mixedbread/resources/data_sources/connectors.py
@@ -237,7 +237,8 @@ def list(
         data_source_id: str,
         *,
         limit: int | NotGiven = NOT_GIVEN,
-        cursor: Optional[str] | NotGiven = NOT_GIVEN,
+        after: Optional[str] | NotGiven = NOT_GIVEN,
+        before: Optional[str] | NotGiven = NOT_GIVEN,
         include_total: bool | NotGiven = NOT_GIVEN,
         # 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.
@@ -257,11 +258,15 @@ def list(
         Args:
           data_source_id: The ID of the data source to get connectors for
 
-          limit: Maximum number of items to return per page
+          limit: Maximum number of items to return per page (1-100)
 
-          cursor: Cursor for pagination (base64 encoded cursor)
+          after: Cursor for forward pagination - get items after this position. Use last_cursor
+              from previous response.
 
-          include_total: Whether to include the total number of items
+          before: Cursor for backward pagination - get items before this position. Use
+              first_cursor from previous response.
+
+          include_total: Whether to include total count in response (expensive operation)
 
           extra_headers: Send extra headers
 
@@ -283,7 +288,8 @@ def list(
                 query=maybe_transform(
                     {
                         "limit": limit,
-                        "cursor": cursor,
+                        "after": after,
+                        "before": before,
                         "include_total": include_total,
                     },
                     connector_list_params.ConnectorListParams,
@@ -550,7 +556,8 @@ async def list(
         data_source_id: str,
         *,
         limit: int | NotGiven = NOT_GIVEN,
-        cursor: Optional[str] | NotGiven = NOT_GIVEN,
+        after: Optional[str] | NotGiven = NOT_GIVEN,
+        before: Optional[str] | NotGiven = NOT_GIVEN,
         include_total: bool | NotGiven = NOT_GIVEN,
         # 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.
@@ -570,11 +577,15 @@ async def list(
         Args:
           data_source_id: The ID of the data source to get connectors for
 
-          limit: Maximum number of items to return per page
+          limit: Maximum number of items to return per page (1-100)
+
+          after: Cursor for forward pagination - get items after this position. Use last_cursor
+              from previous response.
 
-          cursor: Cursor for pagination (base64 encoded cursor)
+          before: Cursor for backward pagination - get items before this position. Use
+              first_cursor from previous response.
 
-          include_total: Whether to include the total number of items
+          include_total: Whether to include total count in response (expensive operation)
 
           extra_headers: Send extra headers
 
@@ -596,7 +607,8 @@ async def list(
                 query=await async_maybe_transform(
                     {
                         "limit": limit,
-                        "cursor": cursor,
+                        "after": after,
+                        "before": before,
                         "include_total": include_total,
                     },
                     connector_list_params.ConnectorListParams,

diff --git a/src/mixedbread/resources/data_sources/data_sources.py b/src/mixedbread/resources/data_sources/data_sources.py
@@ -356,7 +356,8 @@ def list(
         self,
         *,
         limit: int | NotGiven = NOT_GIVEN,
-        cursor: Optional[str] | NotGiven = NOT_GIVEN,
+        after: Optional[str] | NotGiven = NOT_GIVEN,
+        before: Optional[str] | NotGiven = NOT_GIVEN,
         include_total: bool | NotGiven = NOT_GIVEN,
         # 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.
@@ -371,11 +372,15 @@ def list(
         Returns: The list of data sources.
 
         Args:
-          limit: Maximum number of items to return per page
+          limit: Maximum number of items to return per page (1-100)
 
-          cursor: Cursor for pagination (base64 encoded cursor)
+          after: Cursor for forward pagination - get items after this position. Use last_cursor
+              from previous response.
 
-          include_total: Whether to include the total number of items
+          before: Cursor for backward pagination - get items before this position. Use
+              first_cursor from previous response.
+
+          include_total: Whether to include total count in response (expensive operation)
 
           extra_headers: Send extra headers
 
@@ -395,7 +400,8 @@ def list(
                 query=maybe_transform(
                     {
                         "limit": limit,
-                        "cursor": cursor,
+                        "after": after,
+                        "before": before,
                         "include_total": include_total,
                     },
                     data_source_list_params.DataSourceListParams,
@@ -756,7 +762,8 @@ async def list(
         self,
         *,
         limit: int | NotGiven = NOT_GIVEN,
-        cursor: Optional[str] | NotGiven = NOT_GIVEN,
+        after: Optional[str] | NotGiven = NOT_GIVEN,
+        before: Optional[str] | NotGiven = NOT_GIVEN,
         include_total: bool | NotGiven = NOT_GIVEN,
         # 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.
@@ -771,11 +778,15 @@ async def list(
         Returns: The list of data sources.
 
         Args:
-          limit: Maximum number of items to return per page
+          limit: Maximum number of items to return per page (1-100)
+
+          after: Cursor for forward pagination - get items after this position. Use last_cursor
+              from previous response.
 
-          cursor: Cursor for pagination (base64 encoded cursor)
+          before: Cursor for backward pagination - get items before this position. Use
+              first_cursor from previous response.
 
-          include_total: Whether to include the total number of items
+          include_total: Whether to include total count in response (expensive operation)
 
           extra_headers: Send extra headers
 
@@ -795,7 +806,8 @@ async def list(
                 query=await async_maybe_transform(
                     {
                         "limit": limit,
-                        "cursor": cursor,
+                        "after": after,
+                        "before": before,
                         "include_total": include_total,
                     },
                     data_source_list_params.DataSourceListParams,

diff --git a/src/mixedbread/resources/files.py b/src/mixedbread/resources/files.py
@@ -191,8 +191,10 @@ def list(
         self,
         *,
         limit: int | NotGiven = NOT_GIVEN,
-        cursor: Optional[str] | NotGiven = NOT_GIVEN,
+        after: Optional[str] | NotGiven = NOT_GIVEN,
+        before: Optional[str] | NotGiven = NOT_GIVEN,
         include_total: bool | NotGiven = NOT_GIVEN,
+        q: Optional[str] | NotGiven = NOT_GIVEN,
         # 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,
@@ -208,11 +210,17 @@ def list(
         Returns: A list of files belonging to the user.
 
         Args:
-          limit: Maximum number of items to return per page
+          limit: Maximum number of items to return per page (1-100)
 
-          cursor: Cursor for pagination (base64 encoded cursor)
+          after: Cursor for forward pagination - get items after this position. Use last_cursor
+              from previous response.
 
-          include_total: Whether to include the total number of items
+          before: Cursor for backward pagination - get items before this position. Use
+              first_cursor from previous response.
+
+          include_total: Whether to include total count in response (expensive operation)
+
+          q: Search query for fuzzy matching over name and description fields
 
           extra_headers: Send extra headers
 
@@ -232,8 +240,10 @@ def list(
                 query=maybe_transform(
                     {
                         "limit": limit,
-                        "cursor": cursor,
+                        "after": after,
+                        "before": before,
                         "include_total": include_total,
+                        "q": q,
                     },
                     file_list_params.FileListParams,
                 ),
@@ -479,8 +489,10 @@ async def list(
         self,
         *,
         limit: int | NotGiven = NOT_GIVEN,
-        cursor: Optional[str] | NotGiven = NOT_GIVEN,
+        after: Optional[str] | NotGiven = NOT_GIVEN,
+        before: Optional[str] | NotGiven = NOT_GIVEN,
         include_total: bool | NotGiven = NOT_GIVEN,
+        q: Optional[str] | NotGiven = NOT_GIVEN,
         # 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,
@@ -496,11 +508,17 @@ async def list(
         Returns: A list of files belonging to the user.
 
         Args:
-          limit: Maximum number of items to return per page
+          limit: Maximum number of items to return per page (1-100)
+
+          after: Cursor for forward pagination - get items after this position. Use last_cursor
+              from previous response.
+
+          before: Cursor for backward pagination - get items before this position. Use
+              first_cursor from previous response.
 
-          cursor: Cursor for pagination (base64 encoded cursor)
+          include_total: Whether to include total count in response (expensive operation)
 
-          include_total: Whether to include the total number of items
+          q: Search query for fuzzy matching over name and description fields
 
           extra_headers: Send extra headers
 
@@ -520,8 +538,10 @@ async def list(
                 query=await async_maybe_transform(
                     {
                         "limit": limit,
-                        "cursor": cursor,
+                        "after": after,
+                        "before": before,
                         "include_total": include_total,
+                        "q": q,
                     },
                     file_list_params.FileListParams,
                 ),

diff --git a/src/mixedbread/resources/parsing/jobs.py b/src/mixedbread/resources/parsing/jobs.py
@@ -26,6 +26,7 @@
 from ...types.parsing.return_format import ReturnFormat
 from ...types.parsing.chunking_strategy import ChunkingStrategy
 from ...types.parsing.job_list_response import JobListResponse
+from ...types.parsing.parsing_job_status import ParsingJobStatus
 from ...types.parsing.job_delete_response import JobDeleteResponse
 
 __all__ = ["JobsResource", "AsyncJobsResource"]
@@ -153,8 +154,10 @@ def list(
         self,
         *,
         limit: int | NotGiven = NOT_GIVEN,
-        cursor: Optional[str] | NotGiven = NOT_GIVEN,
+        after: Optional[str] | NotGiven = NOT_GIVEN,
+        before: Optional[str] | NotGiven = NOT_GIVEN,
         include_total: bool | NotGiven = NOT_GIVEN,
+        statuses: Optional[List[ParsingJobStatus]] | NotGiven = NOT_GIVEN,
         # 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,
@@ -171,11 +174,17 @@ def list(
         Returns: List of parsing jobs with pagination.
 
         Args:
-          limit: Maximum number of items to return per page
+          limit: Maximum number of items to return per page (1-100)
 
-          cursor: Cursor for pagination (base64 encoded cursor)
+          after: Cursor for forward pagination - get items after this position. Use last_cursor
+              from previous response.
 
-          include_total: Whether to include the total number of items
+          before: Cursor for backward pagination - get items before this position. Use
+              first_cursor from previous response.
+
+          include_total: Whether to include total count in response (expensive operation)
+
+          statuses: Status to filter by
 
           extra_headers: Send extra headers
 
@@ -195,8 +204,10 @@ def list(
                 query=maybe_transform(
                     {
                         "limit": limit,
-                        "cursor": cursor,
+                        "after": after,
+                        "before": before,
                         "include_total": include_total,
+                        "statuses": statuses,
                     },
                     job_list_params.JobListParams,
                 ),
@@ -562,8 +573,10 @@ async def list(
         self,
         *,
         limit: int | NotGiven = NOT_GIVEN,
-        cursor: Optional[str] | NotGiven = NOT_GIVEN,
+        after: Optional[str] | NotGiven = NOT_GIVEN,
+        before: Optional[str] | NotGiven = NOT_GIVEN,
         include_total: bool | NotGiven = NOT_GIVEN,
+        statuses: Optional[List[ParsingJobStatus]] | NotGiven = NOT_GIVEN,
         # 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,
@@ -580,11 +593,17 @@ async def list(
         Returns: List of parsing jobs with pagination.
 
         Args:
-          limit: Maximum number of items to return per page
+          limit: Maximum number of items to return per page (1-100)
+
+          after: Cursor for forward pagination - get items after this position. Use last_cursor
+              from previous response.
+
+          before: Cursor for backward pagination - get items before this position. Use
+              first_cursor from previous response.
 
-          cursor: Cursor for pagination (base64 encoded cursor)
+          include_total: Whether to include total count in response (expensive operation)
 
-          include_total: Whether to include the total number of items
+          statuses: Status to filter by
 
           extra_headers: Send extra headers
 
@@ -604,8 +623,10 @@ async def list(
                 query=await async_maybe_transform(
                     {
                         "limit": limit,
-                        "cursor": cursor,
+                        "after": after,
+                        "before": before,
                         "include_total": include_total,
+                        "statuses": statuses,
                     },
                     job_list_params.JobListParams,
                 ),