release: 1.10.0 (#83)

stainless-app[bot] · web-flow · commit daf984b1785b · 2026-04-06T17:12:26.000Z
* codegen metadata

* feat(api): api update

* feat(api): custom prompts transformations

* release: 1.10.0

---------

Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "1.9.0"
+  ".": "1.10.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 6
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/landingai%2Fade-db7429fa53be03221143cd9bee54ac88df7bab829494a1fc592fb6cd327d9dae.yml
-openapi_spec_hash: f330fd05042391ac9621ce1895eb156b
-config_hash: 79c277ef99c0dbedc6ce5f5cb2b7e81e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/landingai%2Fade-22973c858422fbae26fb3ada2006695fb8f5d5daaf6862e6edb7ed5b8af436b0.yml
+openapi_spec_hash: 5511c4c03ee213ceaf68c9f9d889f861
+config_hash: 0d45e63699ddebca7fd366c1ca124e51
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.10.0 (2026-04-06)
+
+Full Changelog: [v1.9.0...v1.10.0](https://github.com/landing-ai/ade-python/compare/v1.9.0...v1.10.0)
+
+### Features
+
+* **api:** api update ([8213dc8](https://github.com/landing-ai/ade-python/commit/8213dc8f0e8ffa6dc029c10303a95bd93b0eedde))
+* **api:** custom prompts transformations ([5eeee63](https://github.com/landing-ai/ade-python/commit/5eeee63e9242dfe9e6b4eb30d884283b9ba49519))
+
 ## 1.9.0 (2026-03-27)
 
 Full Changelog: [v1.8.0...v1.9.0](https://github.com/landing-ai/ade-python/compare/v1.8.0...v1.9.0)
diff --git a/README.md b/README.md
@@ -261,6 +261,21 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
+## Nested params
+
+Nested parameters are dictionaries, typed using `TypedDict`, for example:
+
+```python
+from landingai_ade import LandingAIADE
+
+client = LandingAIADE()
+
+response = client.parse(
+    custom_prompts={},
+)
+print(response.custom_prompts)
+```
+
 ## File uploads
 
 Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "landingai-ade"
-version = "1.9.0"
+version = "1.10.0"
 description = "The official Python library for the landingai-ade API"
 dynamic = ["readme"]
 license = "Apache-2.0"
diff --git a/src/landingai_ade/_client.py b/src/landingai_ade/_client.py
@@ -294,6 +294,7 @@ def extract(
         markdown: Union[FileTypes, str, None] | Omit = omit,
         markdown_url: Optional[str] | Omit = omit,
         model: Optional[str] | Omit = omit,
+        strict: bool | Omit = omit,
         save_to: str | Path | None = None,
         # 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.
@@ -324,6 +325,9 @@ def extract(
           model: The version of the model to use for extraction. Use `extract-latest` to use the
               latest version.
 
+          strict: If True, reject schemas with unsupported fields (HTTP 422). If False, prune
+              unsupported fields and continue. Only applies to extract versions that support
+              schema validation.
           save_to: Optional output folder path. If provided, the response will be saved as
               JSON to this folder with the filename format: {input_file}_extract_output.json.
               The folder will be created if it doesn't exist.
@@ -348,6 +352,7 @@ def extract(
                 "markdown": markdown,
                 "markdown_url": markdown_url,
                 "model": model,
+                "strict": strict,
             }
         )
         files = extract_files(cast(Mapping[str, object], body), paths=[["markdown"]])
@@ -379,7 +384,7 @@ def extract(
     def parse(
         self,
         *,
-        custom_prompts: Optional[str] | Omit = omit,
+        custom_prompts: Optional[client_parse_params.CustomPrompts] | Omit = omit,
         document: Optional[FileTypes] | Omit = omit,
         document_url: Optional[str] | Omit = omit,
         model: Optional[str] | Omit = omit,
@@ -404,9 +409,7 @@ def parse(
             `https://api.va.eu-west-1.landing.ai/v1/ade/parse`.
 
         Args:
-          custom_prompts: Optional JSON string mapping chunk types to custom parsing prompts. Only the
-              `figure` key is supported, for example '{"figure":"Describe axis labels in
-              detail."}'.
+          custom_prompts: Custom parsing prompts by chunk type. Only `figure` is supported.
 
           document: A file to be parsed. The file can be a PDF or an image. See the list of
               supported file types here: https://docs.landing.ai/ade/ade-file-types. Either
@@ -764,6 +767,7 @@ async def extract(
         markdown: Union[FileTypes, str, None] | Omit = omit,
         markdown_url: Optional[str] | Omit = omit,
         model: Optional[str] | Omit = omit,
+        strict: bool | 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.
         extra_headers: Headers | None = None,
@@ -793,6 +797,10 @@ async def extract(
           model: The version of the model to use for extraction. Use `extract-latest` to use the
               latest version.
 
+          strict: If True, reject schemas with unsupported fields (HTTP 422). If False, prune
+              unsupported fields and continue. Only applies to extract versions that support
+              schema validation.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -810,6 +818,7 @@ async def extract(
                 "markdown": markdown,
                 "markdown_url": markdown_url,
                 "model": model,
+                "strict": strict,
             }
         )
         files = extract_files(cast(Mapping[str, object], body), paths=[["markdown"]])
@@ -837,7 +846,7 @@ async def extract(
     async def parse(
         self,
         *,
-        custom_prompts: Optional[str] | Omit = omit,
+        custom_prompts: Optional[client_parse_params.CustomPrompts] | Omit = omit,
         document: Optional[FileTypes] | Omit = omit,
         document_url: Optional[str] | Omit = omit,
         model: Optional[str] | Omit = omit,
@@ -861,9 +870,7 @@ async def parse(
             `https://api.va.eu-west-1.landing.ai/v1/ade/parse`.
 
         Args:
-          custom_prompts: Optional JSON string mapping chunk types to custom parsing prompts. Only the
-              `figure` key is supported, for example '{"figure":"Describe axis labels in
-              detail."}'.
+          custom_prompts: Custom parsing prompts by chunk type. Only `figure` is supported.
 
           document: A file to be parsed. The file can be a PDF or an image. See the list of
               supported file types here: https://docs.landing.ai/ade/ade-file-types. Either
diff --git a/src/landingai_ade/_version.py b/src/landingai_ade/_version.py
@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "landingai_ade"
-__version__ = "1.9.0"  # x-release-please-version
+__version__ = "1.10.0"  # x-release-please-version
diff --git a/src/landingai_ade/resources/parse_jobs.py b/src/landingai_ade/resources/parse_jobs.py
@@ -49,7 +49,7 @@ def with_streaming_response(self) -> ParseJobsResourceWithStreamingResponse:
     def create(
         self,
         *,
-        custom_prompts: Optional[str] | Omit = omit,
+        custom_prompts: Optional[parse_job_create_params.CustomPrompts] | Omit = omit,
         document: Optional[FileTypes] | Omit = omit,
         document_url: Optional[str] | Omit = omit,
         model: Optional[str] | Omit = omit,
@@ -74,9 +74,7 @@ def create(
             `https://api.va.eu-west-1.landing.ai/v1/ade/parse/jobs`.
 
         Args:
-          custom_prompts: Optional JSON string mapping chunk types to custom parsing prompts. Only the
-              `figure` key is supported, for example '{"figure":"Describe axis labels in
-              detail."}'.
+          custom_prompts: Custom parsing prompts by chunk type. Only `figure` is supported.
 
           document: A file to be parsed. The file can be a PDF or an image. See the list of
               supported file types here: https://docs.landing.ai/ade/ade-file-types. Either
@@ -249,7 +247,7 @@ def with_streaming_response(self) -> AsyncParseJobsResourceWithStreamingResponse
     async def create(
         self,
         *,
-        custom_prompts: Optional[str] | Omit = omit,
+        custom_prompts: Optional[parse_job_create_params.CustomPrompts] | Omit = omit,
         document: Optional[FileTypes] | Omit = omit,
         document_url: Optional[str] | Omit = omit,
         model: Optional[str] | Omit = omit,
@@ -274,9 +272,7 @@ async def create(
             `https://api.va.eu-west-1.landing.ai/v1/ade/parse/jobs`.
 
         Args:
-          custom_prompts: Optional JSON string mapping chunk types to custom parsing prompts. Only the
-              `figure` key is supported, for example '{"figure":"Describe axis labels in
-              detail."}'.
+          custom_prompts: Custom parsing prompts by chunk type. Only `figure` is supported.
 
           document: A file to be parsed. The file can be a PDF or an image. See the list of
               supported file types here: https://docs.landing.ai/ade/ade-file-types. Either
diff --git a/src/landingai_ade/types/client_extract_params.py b/src/landingai_ade/types/client_extract_params.py
@@ -30,3 +30,10 @@ class ClientExtractParams(TypedDict, total=False):
 
     Use `extract-latest` to use the latest version.
     """
+
+    strict: bool
+    """If True, reject schemas with unsupported fields (HTTP 422).
+
+    If False, prune unsupported fields and continue. Only applies to extract
+    versions that support schema validation.
+    """
diff --git a/src/landingai_ade/types/client_parse_params.py b/src/landingai_ade/types/client_parse_params.py
@@ -7,16 +7,12 @@
 
 from .._types import FileTypes
 
-__all__ = ["ClientParseParams"]
+__all__ = ["ClientParseParams", "CustomPrompts"]
 
 
 class ClientParseParams(TypedDict, total=False):
-    custom_prompts: Optional[str]
-    """Optional JSON string mapping chunk types to custom parsing prompts.
-
-    Only the `figure` key is supported, for example '{"figure":"Describe axis labels
-    in detail."}'.
-    """
+    custom_prompts: Optional[CustomPrompts]
+    """Custom parsing prompts by chunk type. Only `figure` is supported."""
 
     document: Optional[FileTypes]
     """A file to be parsed.
@@ -50,3 +46,10 @@ class ClientParseParams(TypedDict, total=False):
     parameter. Set the parameter to page to split documents at the page level. The
     splits object in the API output will contain a set of data for each page.
     """
+
+
+class CustomPrompts(TypedDict, total=False):
+    """Custom parsing prompts by chunk type. Only `figure` is supported."""
+
+    figure: str
+    """Custom parsing prompt for figure chunks."""
diff --git a/src/landingai_ade/types/extract_response.py b/src/landingai_ade/types/extract_response.py
@@ -1,10 +1,19 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import List, Optional
+from typing_extensions import Literal
 
 from .._models import BaseModel
 
-__all__ = ["ExtractResponse", "Metadata"]
+__all__ = ["ExtractResponse", "Metadata", "MetadataWarning"]
+
+
+class MetadataWarning(BaseModel):
+    code: Literal["nonconformant_schema", "nonconformant_output"]
+    """The type of warning, used to translate to a status code downstream"""
+
+    msg: str
+    """Human-readable description of the warning with more details"""
 
 
 class Metadata(BaseModel):
@@ -35,6 +44,15 @@ class Metadata(BaseModel):
     schema.
     """
 
+    warnings: Optional[List[MetadataWarning]] = None
+    """Structured warnings from the extraction process.
+
+    Each warning is an instance of ExtractWarning with 'code' (e.g.
+    'nonconformant_schema') and 'msg' (human-readable description). Present only for
+    extract versions from extract-20260314 and above that support structured
+    warnings.
+    """
+
 
 class ExtractResponse(BaseModel):
     extraction: object
diff --git a/src/landingai_ade/types/parse_job_create_params.py b/src/landingai_ade/types/parse_job_create_params.py
@@ -7,16 +7,12 @@
 
 from .._types import FileTypes
 
-__all__ = ["ParseJobCreateParams"]
+__all__ = ["ParseJobCreateParams", "CustomPrompts"]
 
 
 class ParseJobCreateParams(TypedDict, total=False):
-    custom_prompts: Optional[str]
-    """Optional JSON string mapping chunk types to custom parsing prompts.
-
-    Only the `figure` key is supported, for example '{"figure":"Describe axis labels
-    in detail."}'.
-    """
+    custom_prompts: Optional[CustomPrompts]
+    """Custom parsing prompts by chunk type. Only `figure` is supported."""
 
     document: Optional[FileTypes]
     """A file to be parsed.
@@ -57,3 +53,10 @@ class ParseJobCreateParams(TypedDict, total=False):
     parameter. Set the parameter to page to split documents at the page level. The
     splits object in the API output will contain a set of data for each page.
     """
+
+
+class CustomPrompts(TypedDict, total=False):
+    """Custom parsing prompts by chunk type. Only `figure` is supported."""
+
+    figure: str
+    """Custom parsing prompt for figure chunks."""
diff --git a/tests/api_resources/test_client.py b/tests/api_resources/test_client.py
@@ -37,6 +37,7 @@ def test_method_extract_with_all_params(self, client: LandingAIADE) -> None:
             markdown=b"Example data",
             markdown_url="markdown_url",
             model="model",
+            strict=True,
         )
         assert_matches_type(ExtractResponse, client_, path=["response"])
 
@@ -76,7 +77,7 @@ def test_method_parse(self, client: LandingAIADE) -> None:
     @parametrize
     def test_method_parse_with_all_params(self, client: LandingAIADE) -> None:
         client_ = client.parse(
-            custom_prompts="custom_prompts",
+            custom_prompts={"figure": "figure"},
             document=b"Example data",
             document_url="document_url",
             model="model",
@@ -180,6 +181,7 @@ async def test_method_extract_with_all_params(self, async_client: AsyncLandingAI
             markdown=b"Example data",
             markdown_url="markdown_url",
             model="model",
+            strict=True,
         )
         assert_matches_type(ExtractResponse, client, path=["response"])
 
@@ -219,7 +221,7 @@ async def test_method_parse(self, async_client: AsyncLandingAIADE) -> None:
     @parametrize
     async def test_method_parse_with_all_params(self, async_client: AsyncLandingAIADE) -> None:
         client = await async_client.parse(
-            custom_prompts="custom_prompts",
+            custom_prompts={"figure": "figure"},
             document=b"Example data",
             document_url="document_url",
             model="model",
diff --git a/tests/api_resources/test_parse_jobs.py b/tests/api_resources/test_parse_jobs.py
@@ -31,7 +31,7 @@ def test_method_create(self, client: LandingAIADE) -> None:
     @parametrize
     def test_method_create_with_all_params(self, client: LandingAIADE) -> None:
         parse_job = client.parse_jobs.create(
-            custom_prompts="custom_prompts",
+            custom_prompts={"figure": "figure"},
             document=b"Example data",
             document_url="document_url",
             model="model",
@@ -159,7 +159,7 @@ async def test_method_create(self, async_client: AsyncLandingAIADE) -> None:
     @parametrize
     async def test_method_create_with_all_params(self, async_client: AsyncLandingAIADE) -> None:
         parse_job = await async_client.parse_jobs.create(
-            custom_prompts="custom_prompts",
+            custom_prompts={"figure": "figure"},
             document=b"Example data",
             document_url="document_url",
             model="model",

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "1.9.0"`
	`2`	`+ ".": "1.10.0"`
`3`	`3`	`}`