From 84ebdbfe5204c9ec9d075ed59f00c31fcab7b1b6 Mon Sep 17 00:00:00 2001
From: svc-excavator-bot <svc-excavator-bot@palantir.com>
Date: Mon, 11 May 2026 22:47:08 +0000
Subject: [PATCH] Excavator:  Upgrade API Version

---
 README.md                                     |  6 ++++
 docs-snippets-npm/package.json                |  2 +-
 docs-snippets-npm/src/index.ts                |  2 +-
 docs/v2/Filesystem/models/TrashStatus.md      |  6 +++-
 docs/v2/Ontologies/CipherTextProperty.md      |  2 +-
 docs/v2/SqlQueries/SqlQuery.md                | 11 ++++++--
 .../models/ExecuteSqlQueryRequest.md          |  1 +
 .../SqlQueries/models/SerializationFormat.md  | 12 ++++++++
 foundry_sdk/__init__.py                       |  2 ++
 .../_core/context_and_environment_vars.py     |  5 ++++
 foundry_sdk/_core/http_client.py              |  9 +++++-
 foundry_sdk/_version.py                       |  2 +-
 foundry_sdk/v1/ontologies/errors.py           | 28 +++++++++++++++++++
 foundry_sdk/v2/cli.py                         | 13 +++++++--
 foundry_sdk/v2/filesystem/models.py           |  7 ++++-
 foundry_sdk/v2/ontologies/errors.py           | 28 +++++++++++++++++++
 foundry_sdk/v2/sql_queries/errors.py          | 14 ++++++++++
 foundry_sdk/v2/sql_queries/models.py          |  8 ++++++
 foundry_sdk/v2/sql_queries/sql_query.py       | 20 ++++++++++---
 19 files changed, 162 insertions(+), 16 deletions(-)
 create mode 100644 docs/v2/SqlQueries/models/SerializationFormat.md

diff --git a/README.md b/README.md
index fe17c9a4d..d04865f85 100644
--- a/README.md
+++ b/README.md
@@ -2960,6 +2960,7 @@ Namespace | Name | Import |
 **SqlQueries** | [ParameterValue](docs/v2/SqlQueries/models/ParameterValue.md) | `from foundry_sdk.v2.sql_queries.models import ParameterValue` |
 **SqlQueries** | [QueryStatus](docs/v2/SqlQueries/models/QueryStatus.md) | `from foundry_sdk.v2.sql_queries.models import QueryStatus` |
 **SqlQueries** | [RunningQueryStatus](docs/v2/SqlQueries/models/RunningQueryStatus.md) | `from foundry_sdk.v2.sql_queries.models import RunningQueryStatus` |
+**SqlQueries** | [SerializationFormat](docs/v2/SqlQueries/models/SerializationFormat.md) | `from foundry_sdk.v2.sql_queries.models import SerializationFormat` |
 **SqlQueries** | [SqlQueryId](docs/v2/SqlQueries/models/SqlQueryId.md) | `from foundry_sdk.v2.sql_queries.models import SqlQueryId` |
 **SqlQueries** | [StructColumnFieldType](docs/v2/SqlQueries/models/StructColumnFieldType.md) | `from foundry_sdk.v2.sql_queries.models import StructColumnFieldType` |
 **SqlQueries** | [StructColumnType](docs/v2/SqlQueries/models/StructColumnType.md) | `from foundry_sdk.v2.sql_queries.models import StructColumnType` |
@@ -3738,6 +3739,7 @@ Namespace | Name | Import |
 **Models** | UnsupportedModelSource | `from foundry_sdk.v2.models.errors import UnsupportedModelSource` |
 **Ontologies** | ActionContainsDuplicateEdits | `from foundry_sdk.v2.ontologies.errors import ActionContainsDuplicateEdits` |
 **Ontologies** | ActionEditedPropertiesNotFound | `from foundry_sdk.v2.ontologies.errors import ActionEditedPropertiesNotFound` |
+**Ontologies** | ActionEditsNotSupportedWithMarketplace | `from foundry_sdk.v2.ontologies.errors import ActionEditsNotSupportedWithMarketplace` |
 **Ontologies** | ActionEditsReadOnlyEntity | `from foundry_sdk.v2.ontologies.errors import ActionEditsReadOnlyEntity` |
 **Ontologies** | ActionNotFound | `from foundry_sdk.v2.ontologies.errors import ActionNotFound` |
 **Ontologies** | ActionParameterInterfaceTypeNotFound | `from foundry_sdk.v2.ontologies.errors import ActionParameterInterfaceTypeNotFound` |
@@ -3754,6 +3756,7 @@ Namespace | Name | Import |
 **Ontologies** | AttachmentNotFound | `from foundry_sdk.v2.ontologies.errors import AttachmentNotFound` |
 **Ontologies** | AttachmentRidAlreadyExists | `from foundry_sdk.v2.ontologies.errors import AttachmentRidAlreadyExists` |
 **Ontologies** | AttachmentSizeExceededLimit | `from foundry_sdk.v2.ontologies.errors import AttachmentSizeExceededLimit` |
+**Ontologies** | BranchNotSupportedWithMarketplaceQuery | `from foundry_sdk.v2.ontologies.errors import BranchNotSupportedWithMarketplaceQuery` |
 **Ontologies** | CipherChannelNotFound | `from foundry_sdk.v2.ontologies.errors import CipherChannelNotFound` |
 **Ontologies** | CompositePrimaryKeyNotSupported | `from foundry_sdk.v2.ontologies.errors import CompositePrimaryKeyNotSupported` |
 **Ontologies** | ConsistentSnapshotError | `from foundry_sdk.v2.ontologies.errors import ConsistentSnapshotError` |
@@ -3917,6 +3920,7 @@ Namespace | Name | Import |
 **Orchestration** | TargetNotSupported | `from foundry_sdk.v2.orchestration.errors import TargetNotSupported` |
 **Orchestration** | UnpauseSchedulePermissionDenied | `from foundry_sdk.v2.orchestration.errors import UnpauseSchedulePermissionDenied` |
 **SqlQueries** | CancelSqlQueryPermissionDenied | `from foundry_sdk.v2.sql_queries.errors import CancelSqlQueryPermissionDenied` |
+**SqlQueries** | ColumnTypesNotSupported | `from foundry_sdk.v2.sql_queries.errors import ColumnTypesNotSupported` |
 **SqlQueries** | ExecuteOntologySqlQueryPermissionDenied | `from foundry_sdk.v2.sql_queries.errors import ExecuteOntologySqlQueryPermissionDenied` |
 **SqlQueries** | ExecuteSqlQueryPermissionDenied | `from foundry_sdk.v2.sql_queries.errors import ExecuteSqlQueryPermissionDenied` |
 **SqlQueries** | GetResultsSqlQueryPermissionDenied | `from foundry_sdk.v2.sql_queries.errors import GetResultsSqlQueryPermissionDenied` |
@@ -4057,6 +4061,7 @@ Namespace | Name | Import |
 **Datasets** | UploadFilePermissionDenied | `from foundry_sdk.v1.datasets.errors import UploadFilePermissionDenied` |
 **Ontologies** | ActionContainsDuplicateEdits | `from foundry_sdk.v1.ontologies.errors import ActionContainsDuplicateEdits` |
 **Ontologies** | ActionEditedPropertiesNotFound | `from foundry_sdk.v1.ontologies.errors import ActionEditedPropertiesNotFound` |
+**Ontologies** | ActionEditsNotSupportedWithMarketplace | `from foundry_sdk.v1.ontologies.errors import ActionEditsNotSupportedWithMarketplace` |
 **Ontologies** | ActionEditsReadOnlyEntity | `from foundry_sdk.v1.ontologies.errors import ActionEditsReadOnlyEntity` |
 **Ontologies** | ActionNotFound | `from foundry_sdk.v1.ontologies.errors import ActionNotFound` |
 **Ontologies** | ActionParameterInterfaceTypeNotFound | `from foundry_sdk.v1.ontologies.errors import ActionParameterInterfaceTypeNotFound` |
@@ -4073,6 +4078,7 @@ Namespace | Name | Import |
 **Ontologies** | AttachmentNotFound | `from foundry_sdk.v1.ontologies.errors import AttachmentNotFound` |
 **Ontologies** | AttachmentRidAlreadyExists | `from foundry_sdk.v1.ontologies.errors import AttachmentRidAlreadyExists` |
 **Ontologies** | AttachmentSizeExceededLimit | `from foundry_sdk.v1.ontologies.errors import AttachmentSizeExceededLimit` |
+**Ontologies** | BranchNotSupportedWithMarketplaceQuery | `from foundry_sdk.v1.ontologies.errors import BranchNotSupportedWithMarketplaceQuery` |
 **Ontologies** | CipherChannelNotFound | `from foundry_sdk.v1.ontologies.errors import CipherChannelNotFound` |
 **Ontologies** | CompositePrimaryKeyNotSupported | `from foundry_sdk.v1.ontologies.errors import CompositePrimaryKeyNotSupported` |
 **Ontologies** | ConsistentSnapshotError | `from foundry_sdk.v1.ontologies.errors import ConsistentSnapshotError` |
diff --git a/docs-snippets-npm/package.json b/docs-snippets-npm/package.json
index ff8722703..7241991fe 100644
--- a/docs-snippets-npm/package.json
+++ b/docs-snippets-npm/package.json
@@ -24,7 +24,7 @@
   "sls": {
     "dependencies": {
       "com.palantir.foundry.api:api-gateway": {
-        "minVersion": "1.1593.0",
+        "minVersion": "1.1598.2",
         "maxVersion": "1.x.x",
         "optional": false
       }
diff --git a/docs-snippets-npm/src/index.ts b/docs-snippets-npm/src/index.ts
index e109a3d86..9fc02c32a 100644
--- a/docs-snippets-npm/src/index.ts
+++ b/docs-snippets-npm/src/index.ts
@@ -1875,7 +1875,7 @@ export const PYTHON_PLATFORM_SNIPPETS: SdkSnippets<typeof PLATFORM_API_DOCS_SPEC
         ],
         "v2.executeSqlQuery": [
           {
-            "template": "from foundry_sdk import FoundryClient\nimport foundry_sdk\nfrom pprint import pprint\n\nclient = FoundryClient(auth=foundry_sdk.UserTokenAuth(...), hostname=\"example.palantirfoundry.com\")\n\n# str | The SQL query to execute. Queries should conform to the [Spark SQL dialect](https://spark.apache.org/docs/latest/sql-ref.html). This supports SELECT queries only. Datasets can be referenced in SQL queries by path or by RID. See the  [documentation](https://www.palantir.com/docs/foundry/analytics-connectivity/odbc-jdbc-drivers/#use-sql-to-query-foundry-datasets) for more details.\nquery = \"SELECT * FROM `/Path/To/Dataset`\"\n# Optional[List[BranchName]] | The list of branch ids to use as fallbacks if the query fails to execute on the primary branch. If a is not explicitly provided in the SQL query, the resource will be queried on the first fallback branch provided that exists. If no fallback branches are provided the default branch is used. This is `master` for most enrollments.\nfallback_branch_ids = [\"master\"]\n\n\ntry:\n    api_response = client.sql_queries.SqlQuery.execute(\n        query=query, fallback_branch_ids=fallback_branch_ids\n    )\n    print(\"The execute response:\\n\")\n    pprint(api_response)\nexcept foundry_sdk.PalantirRPCException as e:\n    print(\"HTTP error when calling SqlQuery.execute: %s\\n\" % e)"
+            "template": "from foundry_sdk import FoundryClient\nimport foundry_sdk\nfrom pprint import pprint\n\nclient = FoundryClient(auth=foundry_sdk.UserTokenAuth(...), hostname=\"example.palantirfoundry.com\")\n\n# str | The SQL query to execute. Queries should conform to the [Spark SQL dialect](https://spark.apache.org/docs/latest/sql-ref.html). This supports SELECT queries only. Datasets can be referenced in SQL queries by path or by RID. See the  [documentation](https://www.palantir.com/docs/foundry/analytics-connectivity/odbc-jdbc-drivers/#use-sql-to-query-foundry-datasets) for more details.\nquery = \"SELECT * FROM `/Path/To/Dataset`\"\n# Optional[List[BranchName]] | The list of branch ids to use as fallbacks if the query fails to execute on the primary branch. If a is not explicitly provided in the SQL query, the resource will be queried on the first fallback branch provided that exists. If no fallback branches are provided the default branch is used. This is `master` for most enrollments.\nfallback_branch_ids = [\"master\"]\n# Optional[SerializationFormat] | The format used to serialize query results. If not specified, defaults to `ARROW`.\nserialization_format = \"CSV\"\n\n\ntry:\n    api_response = client.sql_queries.SqlQuery.execute(\n        query=query,\n        fallback_branch_ids=fallback_branch_ids,\n        serialization_format=serialization_format,\n    )\n    print(\"The execute response:\\n\")\n    pprint(api_response)\nexcept foundry_sdk.PalantirRPCException as e:\n    print(\"HTTP error when calling SqlQuery.execute: %s\\n\" % e)"
           }
         ],
         "v2.executeOntologySqlQuery": [
diff --git a/docs/v2/Filesystem/models/TrashStatus.md b/docs/v2/Filesystem/models/TrashStatus.md
index 2a81d0fa5..ef8c7e3aa 100644
--- a/docs/v2/Filesystem/models/TrashStatus.md
+++ b/docs/v2/Filesystem/models/TrashStatus.md
@@ -1,6 +1,10 @@
 # TrashStatus
 
-TrashStatus
+Values:
+  - **DIRECTLY_TRASHED**: The resource was specifically trashed by a user. It can be restored directly.
+  - **ANCESTOR_TRASHED**: A folder that contains this resource was trashed by a user. Restoring this resource requires restoring the original folder.
+  - **NOT_TRASHED**: The default status of resources.
+
 
 | **Value** |
 | --------- |
diff --git a/docs/v2/Ontologies/CipherTextProperty.md b/docs/v2/Ontologies/CipherTextProperty.md
index 48f43bf9f..f9478955a 100644
--- a/docs/v2/Ontologies/CipherTextProperty.md
+++ b/docs/v2/Ontologies/CipherTextProperty.md
@@ -2,7 +2,7 @@
 
 Method | HTTP request | Release Stage |
 ------------- | ------------- | ----- |
-[**decrypt**](#decrypt) | **GET** /v2/ontologies/{ontology}/objects/{objectType}/{primaryKey}/ciphertexts/{property}/decrypt | Public Beta |
+[**decrypt**](#decrypt) | **GET** /v2/ontologies/{ontology}/objects/{objectType}/{primaryKey}/ciphertexts/{property}/decrypt | Stable |
 
 # **decrypt**
 Decrypt the value of a ciphertext property.
diff --git a/docs/v2/SqlQueries/SqlQuery.md b/docs/v2/SqlQueries/SqlQuery.md
index 0878e0812..2c13ea6ca 100644
--- a/docs/v2/SqlQueries/SqlQuery.md
+++ b/docs/v2/SqlQueries/SqlQuery.md
@@ -68,6 +68,7 @@ Name | Type | Description  | Notes |
 ------------- | ------------- | ------------- | ------------- |
 **query** | str | The SQL query to execute. Queries should conform to the [Spark SQL dialect](https://spark.apache.org/docs/latest/sql-ref.html). This supports SELECT queries only. Datasets can be referenced in SQL queries by path or by RID. See the  [documentation](https://www.palantir.com/docs/foundry/analytics-connectivity/odbc-jdbc-drivers/#use-sql-to-query-foundry-datasets) for more details.  |  |
 **fallback_branch_ids** | Optional[List[BranchName]] | The list of branch ids to use as fallbacks if the query fails to execute on the primary branch. If a is not explicitly provided in the SQL query, the resource will be queried on the first fallback branch provided that exists. If no fallback branches are provided the default branch is used. This is `master` for most enrollments.  | [optional] |
+**serialization_format** | Optional[SerializationFormat] | The format used to serialize query results. If not specified, defaults to `ARROW`.  | [optional] |
 
 ### Return type
 **QueryStatus**
@@ -85,11 +86,15 @@ client = FoundryClient(auth=foundry_sdk.UserTokenAuth(...), hostname="example.pa
 query = "SELECT * FROM `/Path/To/Dataset`"
 # Optional[List[BranchName]] | The list of branch ids to use as fallbacks if the query fails to execute on the primary branch. If a is not explicitly provided in the SQL query, the resource will be queried on the first fallback branch provided that exists. If no fallback branches are provided the default branch is used. This is `master` for most enrollments.
 fallback_branch_ids = ["master"]
+# Optional[SerializationFormat] | The format used to serialize query results. If not specified, defaults to `ARROW`.
+serialization_format = "CSV"
 
 
 try:
     api_response = client.sql_queries.SqlQuery.execute(
-        query=query, fallback_branch_ids=fallback_branch_ids
+        query=query,
+        fallback_branch_ids=fallback_branch_ids,
+        serialization_format=serialization_format,
     )
     print("The execute response:\n")
     pprint(api_response)
@@ -175,8 +180,8 @@ See [README](../../../README.md#authorization)
 [[Back to top]](#) [[Back to API list]](../../../README.md#apis-v2-link) [[Back to Model list]](../../../README.md#models-v2-link) [[Back to README]](../../../README.md)
 
 # **get_results**
-Gets the results of a query. The results of the query are returned in the
-[Apache Arrow](https://arrow.apache.org/) format.
+Gets the results of a query. Results are returned in the `serializationFormat` specified at execute time
+(defaulting to [Apache Arrow](https://arrow.apache.org/) if no format is provided).
 
 This endpoint implements long polling and requests will time out after one minute. They can be safely
 retried while the query is still running.
diff --git a/docs/v2/SqlQueries/models/ExecuteSqlQueryRequest.md b/docs/v2/SqlQueries/models/ExecuteSqlQueryRequest.md
index 58bb613dd..14b3d06c7 100644
--- a/docs/v2/SqlQueries/models/ExecuteSqlQueryRequest.md
+++ b/docs/v2/SqlQueries/models/ExecuteSqlQueryRequest.md
@@ -7,6 +7,7 @@ ExecuteSqlQueryRequest
 | ------------ | ------------- | ------------- | ------------- |
 **query** | str | Yes | The SQL query to execute. Queries should conform to the [Spark SQL dialect](https://spark.apache.org/docs/latest/sql-ref.html). This supports SELECT queries only. Datasets can be referenced in SQL queries by path or by RID. See the  [documentation](https://www.palantir.com/docs/foundry/analytics-connectivity/odbc-jdbc-drivers/#use-sql-to-query-foundry-datasets) for more details.  |
 **fallback_branch_ids** | Optional[List[BranchName]] | No | The list of branch ids to use as fallbacks if the query fails to execute on the primary branch. If a is not explicitly provided in the SQL query, the resource will be queried on the first fallback branch provided that exists. If no fallback branches are provided the default branch is used. This is `master` for most enrollments.  |
+**serialization_format** | Optional[SerializationFormat] | No | The format used to serialize query results. If not specified, defaults to `ARROW`.  |
 
 
 [[Back to Model list]](../../../../README.md#models-v2-link) [[Back to API list]](../../../../README.md#apis-v2-link) [[Back to README]](../../../../README.md)
diff --git a/docs/v2/SqlQueries/models/SerializationFormat.md b/docs/v2/SqlQueries/models/SerializationFormat.md
new file mode 100644
index 000000000..237ef704c
--- /dev/null
+++ b/docs/v2/SqlQueries/models/SerializationFormat.md
@@ -0,0 +1,12 @@
+# SerializationFormat
+
+Format for SQL query result serialization.
+
+
+| **Value** |
+| --------- |
+| `"ARROW"` |
+| `"CSV"` |
+
+
+[[Back to Model list]](../../../../README.md#models-v2-link) [[Back to API list]](../../../../README.md#apis-v2-link) [[Back to README]](../../../../README.md)
diff --git a/foundry_sdk/__init__.py b/foundry_sdk/__init__.py
index 4f307851a..decbcc3a9 100644
--- a/foundry_sdk/__init__.py
+++ b/foundry_sdk/__init__.py
@@ -31,6 +31,7 @@
 from foundry_sdk._core import UserTokenAuth
 
 # Context and environment variables
+from foundry_sdk._core.context_and_environment_vars import ADDITIONAL_USER_AGENTS
 from foundry_sdk._core.context_and_environment_vars import ATTRIBUTION_VAR
 from foundry_sdk._core.context_and_environment_vars import HOSTNAME_ENV_VAR
 from foundry_sdk._core.context_and_environment_vars import HOSTNAME_VAR
@@ -86,6 +87,7 @@
     "PublicClientAuth",
     "UserTokenAuth",
     "Config",
+    "ADDITIONAL_USER_AGENTS",
     "ATTRIBUTION_VAR",
     "HOSTNAME_VAR",
     "HOSTNAME_ENV_VAR",
diff --git a/foundry_sdk/_core/context_and_environment_vars.py b/foundry_sdk/_core/context_and_environment_vars.py
index b5fa49ea4..a3592af48 100644
--- a/foundry_sdk/_core/context_and_environment_vars.py
+++ b/foundry_sdk/_core/context_and_environment_vars.py
@@ -38,6 +38,11 @@
 ATTRIBUTION_VAR: ContextVar[Optional[list[str]]] = ContextVar("ATTRIBUTION_RESOURCES", default=None)
 ATTRIBUTION_CONTEXT_VARS: list[ContextVar[Optional[list[str]]]] = [ATTRIBUTION_VAR]
 
+# Additional user agent variables
+ADDITIONAL_USER_AGENTS: ContextVar[Optional[list[str]]] = ContextVar(
+    "ADDITIONAL_USER_AGENTS", default=None
+)
+
 # Trace and Span context variables
 TRACE_ID_VAR: ContextVar[Optional[str]] = ContextVar("FOUNDRY_TRACE_ID", default=None)
 SPAN_ID_VAR: ContextVar[Optional[str]] = ContextVar("FOUNDRY_SPAN_ID", default=None)
diff --git a/foundry_sdk/_core/http_client.py b/foundry_sdk/_core/http_client.py
index 9a6bb4fae..93ff3e51c 100644
--- a/foundry_sdk/_core/http_client.py
+++ b/foundry_sdk/_core/http_client.py
@@ -25,6 +25,7 @@
 import httpx
 
 from foundry_sdk._core.config import Config
+from foundry_sdk._core.context_and_environment_vars import ADDITIONAL_USER_AGENTS
 from foundry_sdk._core.context_and_environment_vars import ATTRIBUTION_CONTEXT_VARS
 from foundry_sdk._core.context_and_environment_vars import SAMPLED_CONTEXT_VARS
 from foundry_sdk._core.context_and_environment_vars import SAMPLED_ENV_VARS
@@ -129,8 +130,14 @@ def _prepare_client_data(
     # https://www.w3.org/Protocols/rfc2616/rfc2616-sec4.html#sec4.2
     attribution_header = ", ".join(attribution) if attribution is not None else None
 
+    user_agent = f"python-foundry-platform-sdk/{__version__} python/{sys.version_info.major}.{sys.version_info.minor}"
+
+    additional_user_agents = ADDITIONAL_USER_AGENTS.get()
+    if additional_user_agents:
+        user_agent += " " + " ".join(additional_user_agents)
+
     headers = {
-        "User-Agent": f"python-foundry-platform-sdk/{__version__} python/{sys.version_info.major}.{sys.version_info.minor}",
+        "User-Agent": user_agent,
         **(config.default_headers or {}),
     }
 
diff --git a/foundry_sdk/_version.py b/foundry_sdk/_version.py
index 3e1180eab..d0c6198a9 100644
--- a/foundry_sdk/_version.py
+++ b/foundry_sdk/_version.py
@@ -17,4 +17,4 @@
 # using the autorelease bot
 __version__ = "0.0.0"
 
-__openapi_document_version__ = "1.1593.0"
+__openapi_document_version__ = "1.1598.2"
diff --git a/foundry_sdk/v1/ontologies/errors.py b/foundry_sdk/v1/ontologies/errors.py
index f1f8613c7..c4e0b0dae 100644
--- a/foundry_sdk/v1/ontologies/errors.py
+++ b/foundry_sdk/v1/ontologies/errors.py
@@ -52,6 +52,19 @@ class ActionEditedPropertiesNotFound(errors.BadRequestError):
     error_instance_id: str
 
 
+class ActionEditsNotSupportedWithMarketplaceParameters(typing_extensions.TypedDict):
+    """Returning action edits is not supported when using marketplace bindings."""
+
+    __pydantic_config__ = {"extra": "allow"}  # type: ignore
+
+
+@dataclass
+class ActionEditsNotSupportedWithMarketplace(errors.BadRequestError):
+    name: typing.Literal["ActionEditsNotSupportedWithMarketplace"]
+    parameters: ActionEditsNotSupportedWithMarketplaceParameters
+    error_instance_id: str
+
+
 class ActionEditsReadOnlyEntityParameters(typing_extensions.TypedDict):
     """The given action request performs edits on a type that is read-only or does not allow edits."""
 
@@ -326,6 +339,19 @@ class AttachmentSizeExceededLimit(errors.BadRequestError):
     error_instance_id: str
 
 
+class BranchNotSupportedWithMarketplaceQueryParameters(typing_extensions.TypedDict):
+    """The branch parameter is not supported when executing queries with marketplace bindings."""
+
+    __pydantic_config__ = {"extra": "allow"}  # type: ignore
+
+
+@dataclass
+class BranchNotSupportedWithMarketplaceQuery(errors.BadRequestError):
+    name: typing.Literal["BranchNotSupportedWithMarketplaceQuery"]
+    parameters: BranchNotSupportedWithMarketplaceQueryParameters
+    error_instance_id: str
+
+
 class CipherChannelNotFoundParameters(typing_extensions.TypedDict):
     """
     The Cipher Channel was not found.
@@ -2448,6 +2474,7 @@ class ViewObjectPermissionDenied(errors.PermissionDeniedError):
 __all__ = [
     "ActionContainsDuplicateEdits",
     "ActionEditedPropertiesNotFound",
+    "ActionEditsNotSupportedWithMarketplace",
     "ActionEditsReadOnlyEntity",
     "ActionNotFound",
     "ActionParameterInterfaceTypeNotFound",
@@ -2464,6 +2491,7 @@ class ViewObjectPermissionDenied(errors.PermissionDeniedError):
     "AttachmentNotFound",
     "AttachmentRidAlreadyExists",
     "AttachmentSizeExceededLimit",
+    "BranchNotSupportedWithMarketplaceQuery",
     "CipherChannelNotFound",
     "CompositePrimaryKeyNotSupported",
     "ConsistentSnapshotError",
diff --git a/foundry_sdk/v2/cli.py b/foundry_sdk/v2/cli.py
index e770eb6f4..eb9777c13 100644
--- a/foundry_sdk/v2/cli.py
+++ b/foundry_sdk/v2/cli.py
@@ -12779,11 +12779,19 @@ def sql_queries_sql_query_op_cancel(
 `master` for most enrollments.
 """,
 )
+@click.option(
+    "--serialization_format",
+    type=click.Choice(["ARROW", "CSV"]),
+    required=False,
+    help="""The format used to serialize query results. If not specified, defaults to `ARROW`.
+""",
+)
 @click.pass_obj
 def sql_queries_sql_query_op_execute(
     client: FoundryClient,
     query: str,
     fallback_branch_ids: typing.Optional[str],
+    serialization_format: typing.Optional[typing.Literal["ARROW", "CSV"]],
 ):
     """
     Executes a new query. Only the user that invoked the query can operate on the query. The size of query
@@ -12796,6 +12804,7 @@ def sql_queries_sql_query_op_execute(
         fallback_branch_ids=(
             None if fallback_branch_ids is None else json.loads(fallback_branch_ids)
         ),
+        serialization_format=serialization_format,
     )
     click.echo(repr(result))
 
@@ -12865,8 +12874,8 @@ def sql_queries_sql_query_op_get_results(
     sql_query_id: str,
 ):
     """
-    Gets the results of a query. The results of the query are returned in the
-    [Apache Arrow](https://arrow.apache.org/) format.
+    Gets the results of a query. Results are returned in the `serializationFormat` specified at execute time
+    (defaulting to [Apache Arrow](https://arrow.apache.org/) if no format is provided).
 
     This endpoint implements long polling and requests will time out after one minute. They can be safely
     retried while the query is still running.
diff --git a/foundry_sdk/v2/filesystem/models.py b/foundry_sdk/v2/filesystem/models.py
index d807f641b..82aff0a9a 100644
--- a/foundry_sdk/v2/filesystem/models.py
+++ b/foundry_sdk/v2/filesystem/models.py
@@ -719,7 +719,12 @@ class Space(core.ModelBase):
 
 
 TrashStatus = typing.Literal["DIRECTLY_TRASHED", "ANCESTOR_TRASHED", "NOT_TRASHED"]
-"""TrashStatus"""
+"""
+Values:
+  - **DIRECTLY_TRASHED**: The resource was specifically trashed by a user. It can be restored directly.
+  - **ANCESTOR_TRASHED**: A folder that contains this resource was trashed by a user. Restoring this resource requires restoring the original folder.
+  - **NOT_TRASHED**: The default status of resources.
+"""
 
 
 UsageAccountRid = core.RID
diff --git a/foundry_sdk/v2/ontologies/errors.py b/foundry_sdk/v2/ontologies/errors.py
index 0098f84bc..c5daa0333 100644
--- a/foundry_sdk/v2/ontologies/errors.py
+++ b/foundry_sdk/v2/ontologies/errors.py
@@ -52,6 +52,19 @@ class ActionEditedPropertiesNotFound(errors.BadRequestError):
     error_instance_id: str
 
 
+class ActionEditsNotSupportedWithMarketplaceParameters(typing_extensions.TypedDict):
+    """Returning action edits is not supported when using marketplace bindings."""
+
+    __pydantic_config__ = {"extra": "allow"}  # type: ignore
+
+
+@dataclass
+class ActionEditsNotSupportedWithMarketplace(errors.BadRequestError):
+    name: typing.Literal["ActionEditsNotSupportedWithMarketplace"]
+    parameters: ActionEditsNotSupportedWithMarketplaceParameters
+    error_instance_id: str
+
+
 class ActionEditsReadOnlyEntityParameters(typing_extensions.TypedDict):
     """The given action request performs edits on a type that is read-only or does not allow edits."""
 
@@ -326,6 +339,19 @@ class AttachmentSizeExceededLimit(errors.BadRequestError):
     error_instance_id: str
 
 
+class BranchNotSupportedWithMarketplaceQueryParameters(typing_extensions.TypedDict):
+    """The branch parameter is not supported when executing queries with marketplace bindings."""
+
+    __pydantic_config__ = {"extra": "allow"}  # type: ignore
+
+
+@dataclass
+class BranchNotSupportedWithMarketplaceQuery(errors.BadRequestError):
+    name: typing.Literal["BranchNotSupportedWithMarketplaceQuery"]
+    parameters: BranchNotSupportedWithMarketplaceQueryParameters
+    error_instance_id: str
+
+
 class CipherChannelNotFoundParameters(typing_extensions.TypedDict):
     """
     The Cipher Channel was not found.
@@ -2448,6 +2474,7 @@ class ViewObjectPermissionDenied(errors.PermissionDeniedError):
 __all__ = [
     "ActionContainsDuplicateEdits",
     "ActionEditedPropertiesNotFound",
+    "ActionEditsNotSupportedWithMarketplace",
     "ActionEditsReadOnlyEntity",
     "ActionNotFound",
     "ActionParameterInterfaceTypeNotFound",
@@ -2464,6 +2491,7 @@ class ViewObjectPermissionDenied(errors.PermissionDeniedError):
     "AttachmentNotFound",
     "AttachmentRidAlreadyExists",
     "AttachmentSizeExceededLimit",
+    "BranchNotSupportedWithMarketplaceQuery",
     "CipherChannelNotFound",
     "CompositePrimaryKeyNotSupported",
     "ConsistentSnapshotError",
diff --git a/foundry_sdk/v2/sql_queries/errors.py b/foundry_sdk/v2/sql_queries/errors.py
index c0c58033f..b3d971404 100644
--- a/foundry_sdk/v2/sql_queries/errors.py
+++ b/foundry_sdk/v2/sql_queries/errors.py
@@ -35,6 +35,19 @@ class CancelSqlQueryPermissionDenied(errors.PermissionDeniedError):
     error_instance_id: str
 
 
+class ColumnTypesNotSupportedParameters(typing_extensions.TypedDict):
+    """The query result contains column types that are not supported by the requested serialization format."""
+
+    __pydantic_config__ = {"extra": "allow"}  # type: ignore
+
+
+@dataclass
+class ColumnTypesNotSupported(errors.BadRequestError):
+    name: typing.Literal["ColumnTypesNotSupported"]
+    parameters: ColumnTypesNotSupportedParameters
+    error_instance_id: str
+
+
 class ExecuteOntologySqlQueryPermissionDeniedParameters(typing_extensions.TypedDict):
     """Could not executeOntology the SqlQuery."""
 
@@ -189,6 +202,7 @@ class ReadQueryInputsPermissionDenied(errors.PermissionDeniedError):
 
 __all__ = [
     "CancelSqlQueryPermissionDenied",
+    "ColumnTypesNotSupported",
     "ExecuteOntologySqlQueryPermissionDenied",
     "ExecuteSqlQueryPermissionDenied",
     "GetResultsSqlQueryPermissionDenied",
diff --git a/foundry_sdk/v2/sql_queries/models.py b/foundry_sdk/v2/sql_queries/models.py
index 2ff3b34a4..443f0e7ee 100644
--- a/foundry_sdk/v2/sql_queries/models.py
+++ b/foundry_sdk/v2/sql_queries/models.py
@@ -108,6 +108,9 @@ class ExecuteSqlQueryRequest(core.ModelBase):
     `master` for most enrollments.
     """
 
+    serialization_format: typing.Optional[SerializationFormat] = pydantic.Field(alias=str("serializationFormat"), default=None)  # type: ignore[literal-required]
+    """The format used to serialize query results. If not specified, defaults to `ARROW`."""
+
 
 class FailedQueryStatus(core.ModelBase):
     """FailedQueryStatus"""
@@ -306,6 +309,10 @@ class RunningQueryStatus(core.ModelBase):
     type: typing.Literal["running"] = "running"
 
 
+SerializationFormat = typing.Literal["ARROW", "CSV"]
+"""Format for SQL query result serialization."""
+
+
 SqlQueryId = str
 """The identifier of a SQL Query."""
 
@@ -405,6 +412,7 @@ class UnnamedParameterValues(core.ModelBase):
     "Parameters",
     "QueryStatus",
     "RunningQueryStatus",
+    "SerializationFormat",
     "SqlQueryId",
     "StructColumnFieldType",
     "StructColumnType",
diff --git a/foundry_sdk/v2/sql_queries/sql_query.py b/foundry_sdk/v2/sql_queries/sql_query.py
index 1bd5480da..a8ad92df2 100644
--- a/foundry_sdk/v2/sql_queries/sql_query.py
+++ b/foundry_sdk/v2/sql_queries/sql_query.py
@@ -116,6 +116,7 @@ def execute(
         *,
         query: str,
         fallback_branch_ids: typing.Optional[typing.List[core_models.BranchName]] = None,
+        serialization_format: typing.Optional[sql_queries_models.SerializationFormat] = None,
         request_timeout: typing.Optional[core.Timeout] = None,
         _sdk_internal: core.SdkInternal = {},
     ) -> sql_queries_models.QueryStatus:
@@ -128,11 +129,14 @@ def execute(
         :type query: str
         :param fallback_branch_ids: The list of branch ids to use as fallbacks if the query fails to execute on the primary branch. If a is not explicitly provided in the SQL query, the resource will be queried on the first fallback branch provided that exists. If no fallback branches are provided the default branch is used. This is `master` for most enrollments.
         :type fallback_branch_ids: Optional[List[BranchName]]
+        :param serialization_format: The format used to serialize query results. If not specified, defaults to `ARROW`.
+        :type serialization_format: Optional[SerializationFormat]
         :param request_timeout: timeout setting for this request in seconds.
         :type request_timeout: Optional[int]
         :return: Returns the result object.
         :rtype: sql_queries_models.QueryStatus
 
+        :raises ColumnTypesNotSupported: The query result contains column types that are not supported by the requested serialization format.
         :raises ExecuteSqlQueryPermissionDenied: Could not execute the SqlQuery.
         :raises QueryCanceled: The query was canceled.
         :raises QueryFailed: The query failed.
@@ -155,10 +159,12 @@ def execute(
                 body=sql_queries_models.ExecuteSqlQueryRequest(
                     query=query,
                     fallback_branch_ids=fallback_branch_ids,
+                    serialization_format=serialization_format,
                 ),
                 response_type=sql_queries_models.QueryStatus,
                 request_timeout=request_timeout,
                 throwable_errors={
+                    "ColumnTypesNotSupported": sql_queries_errors.ColumnTypesNotSupported,
                     "ExecuteSqlQueryPermissionDenied": sql_queries_errors.ExecuteSqlQueryPermissionDenied,
                     "QueryCanceled": sql_queries_errors.QueryCanceled,
                     "QueryFailed": sql_queries_errors.QueryFailed,
@@ -249,8 +255,8 @@ def get_results(
         _sdk_internal: core.SdkInternal = {},
     ) -> core.TableResponse:
         """
-        Gets the results of a query. The results of the query are returned in the
-        [Apache Arrow](https://arrow.apache.org/) format.
+        Gets the results of a query. Results are returned in the `serializationFormat` specified at execute time
+        (defaulting to [Apache Arrow](https://arrow.apache.org/) if no format is provided).
 
         This endpoint implements long polling and requests will time out after one minute. They can be safely
         retried while the query is still running.
@@ -477,6 +483,7 @@ def execute(
         *,
         query: str,
         fallback_branch_ids: typing.Optional[typing.List[core_models.BranchName]] = None,
+        serialization_format: typing.Optional[sql_queries_models.SerializationFormat] = None,
         request_timeout: typing.Optional[core.Timeout] = None,
         _sdk_internal: core.SdkInternal = {},
     ) -> typing.Awaitable[sql_queries_models.QueryStatus]:
@@ -489,11 +496,14 @@ def execute(
         :type query: str
         :param fallback_branch_ids: The list of branch ids to use as fallbacks if the query fails to execute on the primary branch. If a is not explicitly provided in the SQL query, the resource will be queried on the first fallback branch provided that exists. If no fallback branches are provided the default branch is used. This is `master` for most enrollments.
         :type fallback_branch_ids: Optional[List[BranchName]]
+        :param serialization_format: The format used to serialize query results. If not specified, defaults to `ARROW`.
+        :type serialization_format: Optional[SerializationFormat]
         :param request_timeout: timeout setting for this request in seconds.
         :type request_timeout: Optional[int]
         :return: Returns the result object.
         :rtype: typing.Awaitable[sql_queries_models.QueryStatus]
 
+        :raises ColumnTypesNotSupported: The query result contains column types that are not supported by the requested serialization format.
         :raises ExecuteSqlQueryPermissionDenied: Could not execute the SqlQuery.
         :raises QueryCanceled: The query was canceled.
         :raises QueryFailed: The query failed.
@@ -516,10 +526,12 @@ def execute(
                 body=sql_queries_models.ExecuteSqlQueryRequest(
                     query=query,
                     fallback_branch_ids=fallback_branch_ids,
+                    serialization_format=serialization_format,
                 ),
                 response_type=sql_queries_models.QueryStatus,
                 request_timeout=request_timeout,
                 throwable_errors={
+                    "ColumnTypesNotSupported": sql_queries_errors.ColumnTypesNotSupported,
                     "ExecuteSqlQueryPermissionDenied": sql_queries_errors.ExecuteSqlQueryPermissionDenied,
                     "QueryCanceled": sql_queries_errors.QueryCanceled,
                     "QueryFailed": sql_queries_errors.QueryFailed,
@@ -610,8 +622,8 @@ def get_results(
         _sdk_internal: core.SdkInternal = {},
     ) -> typing.Awaitable[core.TableResponse]:
         """
-                Gets the results of a query. The results of the query are returned in the
-                [Apache Arrow](https://arrow.apache.org/) format.
+                Gets the results of a query. Results are returned in the `serializationFormat` specified at execute time
+                (defaulting to [Apache Arrow](https://arrow.apache.org/) if no format is provided).
 
                 This endpoint implements long polling and requests will time out after one minute. They can be safely
                 retried while the query is still running.