diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index ff66120..dd7ced1 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.48.0"
+  ".": "0.49.0"
 }
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index 0538f50..4bb5a62 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 56
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mixedbread%2Fmixedbread-aee97de4d3aed6b0d4c4ace37a0b32972f51502127796354b791ee61d5176eab.yml
-openapi_spec_hash: 3752a46f3eca4db340f0fe9df10fed44
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mixedbread%2Fmixedbread-3daf4d41b24950791a70688527c10dea9e201d304b8d6432b3acfa50e33e0805.yml
+openapi_spec_hash: 1ecaa0f38266f1c5d1da8fb2e9ef651a
 config_hash: c32ffa6858a02d7f23f6f3dda0b461ed
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f1b76c5..449aae0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.49.0 (2026-03-19)
+
+Full Changelog: [v0.48.0...v0.49.0](https://github.com/mixedbread-ai/mixedbread-python/compare/v0.48.0...v0.49.0)
+
+### Features
+
+* **api:** api update ([dc87556](https://github.com/mixedbread-ai/mixedbread-python/commit/dc875560329b32cf5fc0421a162af671bb956e7c))
+
 ## 0.48.0 (2026-03-18)
 
 Full Changelog: [v0.47.1...v0.48.0](https://github.com/mixedbread-ai/mixedbread-python/compare/v0.47.1...v0.48.0)
diff --git a/pyproject.toml b/pyproject.toml
index 19690ba..d39892a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "mixedbread"
-version = "0.48.0"
+version = "0.49.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
index 85574aa..40dca85 100644
--- 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.48.0"  # x-release-please-version
+__version__ = "0.49.0"  # x-release-please-version
diff --git a/src/mixedbread/resources/stores/stores.py b/src/mixedbread/resources/stores/stores.py
index 41eac71..1834f5a 100644
--- a/src/mixedbread/resources/stores/stores.py
+++ b/src/mixedbread/resources/stores/stores.py
@@ -422,6 +422,7 @@ def question_answering(
         file_ids: Union[Iterable[object], SequenceNotStr[str], None] | Omit = omit,
         search_options: StoreChunkSearchOptionsParam | Omit = omit,
         stream: bool | Omit = omit,
+        instructions: Optional[str] | Omit = omit,
         qa_options: store_question_answering_params.QaOptions | 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.
@@ -450,6 +451,9 @@ def question_answering(
 
           stream: Whether to stream the answer
 
+          instructions: Additional custom instructions (followed only when not in conflict with existing
+              rules)
+
           qa_options: Question answering configuration options
 
           extra_headers: Send extra headers
@@ -471,6 +475,7 @@ def question_answering(
                     "file_ids": file_ids,
                     "search_options": search_options,
                     "stream": stream,
+                    "instructions": instructions,
                     "qa_options": qa_options,
                 },
                 store_question_answering_params.StoreQuestionAnsweringParams,
@@ -938,6 +943,7 @@ async def question_answering(
         file_ids: Union[Iterable[object], SequenceNotStr[str], None] | Omit = omit,
         search_options: StoreChunkSearchOptionsParam | Omit = omit,
         stream: bool | Omit = omit,
+        instructions: Optional[str] | Omit = omit,
         qa_options: store_question_answering_params.QaOptions | 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.
@@ -966,6 +972,9 @@ async def question_answering(
 
           stream: Whether to stream the answer
 
+          instructions: Additional custom instructions (followed only when not in conflict with existing
+              rules)
+
           qa_options: Question answering configuration options
 
           extra_headers: Send extra headers
@@ -987,6 +996,7 @@ async def question_answering(
                     "file_ids": file_ids,
                     "search_options": search_options,
                     "stream": stream,
+                    "instructions": instructions,
                     "qa_options": qa_options,
                 },
                 store_question_answering_params.StoreQuestionAnsweringParams,
diff --git a/src/mixedbread/types/store_chunk_search_options_param.py b/src/mixedbread/types/store_chunk_search_options_param.py
index 90bb981..95d76cd 100644
--- a/src/mixedbread/types/store_chunk_search_options_param.py
+++ b/src/mixedbread/types/store_chunk_search_options_param.py
@@ -38,6 +38,12 @@ class AgenticAgenticSearchConfig(TypedDict, total=False):
     queries_per_round: int
     """Maximum queries per round"""
 
+    instructions: Optional[str]
+    """
+    Additional custom instructions (followed only when not in conflict with existing
+    rules)
+    """
+
 
 Agentic: TypeAlias = Union[bool, AgenticAgenticSearchConfig]
 
diff --git a/src/mixedbread/types/store_question_answering_params.py b/src/mixedbread/types/store_question_answering_params.py
index 26abbb4..e2eaefb 100644
--- a/src/mixedbread/types/store_question_answering_params.py
+++ b/src/mixedbread/types/store_question_answering_params.py
@@ -37,6 +37,12 @@ class StoreQuestionAnsweringParams(TypedDict, total=False):
     stream: bool
     """Whether to stream the answer"""
 
+    instructions: Optional[str]
+    """
+    Additional custom instructions (followed only when not in conflict with existing
+    rules)
+    """
+
     qa_options: QaOptions
     """Question answering configuration options"""
 
diff --git a/src/mixedbread/types/stores/file_search_params.py b/src/mixedbread/types/stores/file_search_params.py
index 6f6aa2d..c1b5dee 100644
--- a/src/mixedbread/types/stores/file_search_params.py
+++ b/src/mixedbread/types/stores/file_search_params.py
@@ -78,6 +78,12 @@ class SearchOptionsAgenticAgenticSearchConfig(TypedDict, total=False):
     queries_per_round: int
     """Maximum queries per round"""
 
+    instructions: Optional[str]
+    """
+    Additional custom instructions (followed only when not in conflict with existing
+    rules)
+    """
+
 
 SearchOptionsAgentic: TypeAlias = Union[bool, SearchOptionsAgenticAgenticSearchConfig]
 
diff --git a/tests/api_resources/test_stores.py b/tests/api_resources/test_stores.py
index 0a07670..5e8ae60 100644
--- a/tests/api_resources/test_stores.py
+++ b/tests/api_resources/test_stores.py
@@ -316,6 +316,7 @@ def test_method_question_answering_with_all_params(self, client: Mixedbread) ->
                 "apply_search_rules": True,
             },
             stream=True,
+            instructions="x",
             qa_options={
                 "cite": True,
                 "multimodal": True,
@@ -702,6 +703,7 @@ async def test_method_question_answering_with_all_params(self, async_client: Asy
                 "apply_search_rules": True,
             },
             stream=True,
+            instructions="x",
             qa_options={
                 "cite": True,
                 "multimodal": True,