feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 10
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/unlayer/unlayer-35699cec89167aa9ce539f8008695911611f8bdf923234ed701ee3dbc0c5bcd2.yml
-openapi_spec_hash: 2ec4eef9500ac0007e1740f431835931
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/unlayer/unlayer-091234302d1c0907a6e2c646ad31f2757e832985758314af9171390851ffc12f.yml
+openapi_spec_hash: bbac170e82fb6bb60e0db638457623d1
 config_hash: 20e7fbba9d423291aaf676f6a629dcaf

src/unlayer/resources/templates/generate.py

@@ -2,11 +2,11 @@
 
 from __future__ import annotations
 
-from typing import Iterable
+from typing import Union, Iterable
 
 import httpx
 
-from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
+from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
@@ -51,6 +51,7 @@ def create(
         project_id: str | Omit = omit,
         context: generate_create_params.Context | Omit = omit,
         conversation_id: str | Omit = omit,
+        fallback_models: Union[bool, SequenceNotStr[str]] | Omit = omit,
         locale: str | Omit = omit,
         model: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -81,10 +82,14 @@ def create(
 
           conversation_id: Reserved for future server-side conversation memory.
 
+          fallback_models: Transient-outage fallback controls. Omit to use Unlayer defaults only when no
+              model is pinned; true always uses Unlayer defaults; false disables the outage
+              tail; an ordered array replaces the default provider/model strings.
+
           locale: BCP-47 fallback locale for AI status messages.
 
-          model: AI model in "provider/id" form, e.g. "anthropic/claude-opus-4-7". Optional —
-              server resolves a default per output kind.
+          model: Preferred AI model in "provider/id" form, e.g. "anthropic/claude-opus-4-7".
+              Optional — server resolves a default per output kind.
 
           extra_headers: Send extra headers
 
@@ -102,6 +107,7 @@ def create(
                     "output": output,
                     "context": context,
                     "conversation_id": conversation_id,
+                    "fallback_models": fallback_models,
                     "locale": locale,
                     "model": model,
                 },
@@ -165,6 +171,7 @@ async def create(
         project_id: str | Omit = omit,
         context: generate_create_params.Context | Omit = omit,
         conversation_id: str | Omit = omit,
+        fallback_models: Union[bool, SequenceNotStr[str]] | Omit = omit,
         locale: str | Omit = omit,
         model: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -195,10 +202,14 @@ async def create(
 
           conversation_id: Reserved for future server-side conversation memory.
 
+          fallback_models: Transient-outage fallback controls. Omit to use Unlayer defaults only when no
+              model is pinned; true always uses Unlayer defaults; false disables the outage
+              tail; an ordered array replaces the default provider/model strings.
+
           locale: BCP-47 fallback locale for AI status messages.
 
-          model: AI model in "provider/id" form, e.g. "anthropic/claude-opus-4-7". Optional —
-              server resolves a default per output kind.
+          model: Preferred AI model in "provider/id" form, e.g. "anthropic/claude-opus-4-7".
+              Optional — server resolves a default per output kind.
 
           extra_headers: Send extra headers
 
@@ -216,6 +227,7 @@ async def create(
                     "output": output,
                     "context": context,
                     "conversation_id": conversation_id,
+                    "fallback_models": fallback_models,
                     "locale": locale,
                     "model": model,
                 },

src/unlayer/resources/templates/import_.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-from typing import Iterable
+from typing import Union, Iterable
 from typing_extensions import Literal
 
 import httpx
 
-from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
@@ -54,6 +54,7 @@ def create(
         display_mode: Literal["email", "web", "popup", "document"],
         input: Iterable[import_create_params.Input],
         project_id: str | Omit = omit,
+        fallback_models: Union[bool, SequenceNotStr[str]] | Omit = omit,
         model: 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.
@@ -74,7 +75,11 @@ def create(
 
           project_id: The project ID (required for PAT auth, auto-resolved for API key auth)
 
-          model: AI model to use. Accepts a provider/model string (e.g.
+          fallback_models: Transient-outage fallback controls. Omit to use Unlayer defaults only when no
+              model is pinned; true always uses Unlayer defaults; false disables the outage
+              tail; an ordered array replaces the default provider/model strings.
+
+          model: Preferred AI model. Accepts a provider/model string (e.g.
               "anthropic/claude-opus-4-7", "openai/gpt-5.5"), a bare provider ("anthropic",
               "openai") which uses that provider's default model, or a bare model id
               ("claude-opus-4-7", "gpt-5.5") with the provider inferred from the name.
@@ -94,6 +99,7 @@ def create(
                 {
                     "display_mode": display_mode,
                     "input": input,
+                    "fallback_models": fallback_models,
                     "model": model,
                 },
                 import_create_params.ImportCreateParams,
@@ -139,6 +145,7 @@ async def create(
         display_mode: Literal["email", "web", "popup", "document"],
         input: Iterable[import_create_params.Input],
         project_id: str | Omit = omit,
+        fallback_models: Union[bool, SequenceNotStr[str]] | Omit = omit,
         model: 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.
@@ -159,7 +166,11 @@ async def create(
 
           project_id: The project ID (required for PAT auth, auto-resolved for API key auth)
 
-          model: AI model to use. Accepts a provider/model string (e.g.
+          fallback_models: Transient-outage fallback controls. Omit to use Unlayer defaults only when no
+              model is pinned; true always uses Unlayer defaults; false disables the outage
+              tail; an ordered array replaces the default provider/model strings.
+
+          model: Preferred AI model. Accepts a provider/model string (e.g.
               "anthropic/claude-opus-4-7", "openai/gpt-5.5"), a bare provider ("anthropic",
               "openai") which uses that provider's default model, or a bare model id
               ("claude-opus-4-7", "gpt-5.5") with the provider inferred from the name.
@@ -179,6 +190,7 @@ async def create(
                 {
                     "display_mode": display_mode,
                     "input": input,
+                    "fallback_models": fallback_models,
                     "model": model,
                 },
                 import_create_params.ImportCreateParams,

src/unlayer/types/templates/generate_create_params.py

@@ -42,11 +42,19 @@ class GenerateCreateParams(TypedDict, total=False):
     conversation_id: Annotated[str, PropertyInfo(alias="conversationId")]
     """Reserved for future server-side conversation memory."""
 
+    fallback_models: Annotated[Union[bool, SequenceNotStr[str]], PropertyInfo(alias="fallbackModels")]
+    """Transient-outage fallback controls.
+
+    Omit to use Unlayer defaults only when no model is pinned; true always uses
+    Unlayer defaults; false disables the outage tail; an ordered array replaces the
+    default provider/model strings.
+    """
+
     locale: str
     """BCP-47 fallback locale for AI status messages."""
 
     model: str
-    """AI model in "provider/id" form, e.g.
+    """Preferred AI model in "provider/id" form, e.g.
 
     "anthropic/claude-opus-4-7". Optional — server resolves a default per output
     kind.

src/unlayer/types/templates/import_create_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import Iterable
+from typing import Union, Iterable
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
+from ..._types import SequenceNotStr
 from ..._utils import PropertyInfo
 
 __all__ = ["ImportCreateParams", "Input"]
@@ -24,8 +25,16 @@ class ImportCreateParams(TypedDict, total=False):
     project_id: Annotated[str, PropertyInfo(alias="projectId")]
     """The project ID (required for PAT auth, auto-resolved for API key auth)"""
 
+    fallback_models: Annotated[Union[bool, SequenceNotStr[str]], PropertyInfo(alias="fallbackModels")]
+    """Transient-outage fallback controls.
+
+    Omit to use Unlayer defaults only when no model is pinned; true always uses
+    Unlayer defaults; false disables the outage tail; an ordered array replaces the
+    default provider/model strings.
+    """
+
     model: str
-    """AI model to use.
+    """Preferred AI model.
 
     Accepts a provider/model string (e.g. "anthropic/claude-opus-4-7",
     "openai/gpt-5.5"), a bare provider ("anthropic", "openai") which uses that

tests/api_resources/templates/test_generate.py

@@ -75,6 +75,7 @@ def test_method_create_with_all_params(self, client: Unlayer) -> None:
                 },
             },
             conversation_id="conversationId",
+            fallback_models=True,
             locale="locale",
             model="model",
         )
@@ -211,6 +212,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncUnlayer) -
                 },
             },
             conversation_id="conversationId",
+            fallback_models=True,
             locale="locale",
             model="model",
         )

tests/api_resources/templates/test_import_.py

@@ -39,6 +39,7 @@ def test_method_create_with_all_params(self, client: Unlayer) -> None:
                 }
             ],
             project_id="projectId",
+            fallback_models=True,
             model="model",
         )
         assert_matches_type(ImportCreateResponse, import_, path=["response"])
@@ -97,6 +98,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncUnlayer) -
                 }
             ],
             project_id="projectId",
+            fallback_models=True,
             model="model",
         )
         assert_matches_type(ImportCreateResponse, import_, path=["response"])