robosystems-client 0.2.14__py3-none-any.whl → 0.2.16__py3-none-any.whl

robosystems_client/api/org_members/update_org_member_role.py

@@ -1,5 +1,5 @@
 from http import HTTPStatus
-from typing import Any, Optional, Union
+from typing import Any
 
 import httpx
 
@@ -33,8 +33,8 @@ def _get_kwargs(
 
 
 def _parse_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[HTTPValidationError, OrgMemberResponse]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> HTTPValidationError | OrgMemberResponse | None:
   if response.status_code == 200:
     response_200 = OrgMemberResponse.from_dict(response.json())
 
@@ -52,8 +52,8 @@ def _parse_response(
 
 
 def _build_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[HTTPValidationError, OrgMemberResponse]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[HTTPValidationError | OrgMemberResponse]:
   return Response(
     status_code=HTTPStatus(response.status_code),
     content=response.content,
@@ -68,7 +68,7 @@ def sync_detailed(
   *,
   client: AuthenticatedClient,
   body: UpdateMemberRoleRequest,
-) -> Response[Union[HTTPValidationError, OrgMemberResponse]]:
+) -> Response[HTTPValidationError | OrgMemberResponse]:
   """Update Member Role
 
    Update a member's role in the organization. Requires admin or owner role.
@@ -83,7 +83,7 @@ def sync_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[HTTPValidationError, OrgMemberResponse]]
+      Response[HTTPValidationError | OrgMemberResponse]
   """
 
   kwargs = _get_kwargs(
@@ -105,7 +105,7 @@ def sync(
   *,
   client: AuthenticatedClient,
   body: UpdateMemberRoleRequest,
-) -> Optional[Union[HTTPValidationError, OrgMemberResponse]]:
+) -> HTTPValidationError | OrgMemberResponse | None:
   """Update Member Role
 
    Update a member's role in the organization. Requires admin or owner role.
@@ -120,7 +120,7 @@ def sync(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[HTTPValidationError, OrgMemberResponse]
+      HTTPValidationError | OrgMemberResponse
   """
 
   return sync_detailed(
@@ -137,7 +137,7 @@ async def asyncio_detailed(
   *,
   client: AuthenticatedClient,
   body: UpdateMemberRoleRequest,
-) -> Response[Union[HTTPValidationError, OrgMemberResponse]]:
+) -> Response[HTTPValidationError | OrgMemberResponse]:
   """Update Member Role
 
    Update a member's role in the organization. Requires admin or owner role.
@@ -152,7 +152,7 @@ async def asyncio_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[HTTPValidationError, OrgMemberResponse]]
+      Response[HTTPValidationError | OrgMemberResponse]
   """
 
   kwargs = _get_kwargs(
@@ -172,7 +172,7 @@ async def asyncio(
   *,
   client: AuthenticatedClient,
   body: UpdateMemberRoleRequest,
-) -> Optional[Union[HTTPValidationError, OrgMemberResponse]]:
+) -> HTTPValidationError | OrgMemberResponse | None:
   """Update Member Role
 
    Update a member's role in the organization. Requires admin or owner role.
@@ -187,7 +187,7 @@ async def asyncio(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[HTTPValidationError, OrgMemberResponse]
+      HTTPValidationError | OrgMemberResponse
   """
 
   return (

robosystems_client/api/org_usage/get_org_limits.py

@@ -1,5 +1,5 @@
 from http import HTTPStatus
-from typing import Any, Optional, Union
+from typing import Any
 
 import httpx
 
@@ -22,8 +22,8 @@ def _get_kwargs(
 
 
 def _parse_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[HTTPValidationError, OrgLimitsResponse]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> HTTPValidationError | OrgLimitsResponse | None:
   if response.status_code == 200:
     response_200 = OrgLimitsResponse.from_dict(response.json())
 
@@ -41,8 +41,8 @@ def _parse_response(
 
 
 def _build_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[HTTPValidationError, OrgLimitsResponse]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[HTTPValidationError | OrgLimitsResponse]:
   return Response(
     status_code=HTTPStatus(response.status_code),
     content=response.content,
@@ -55,7 +55,7 @@ def sync_detailed(
   org_id: str,
   *,
   client: AuthenticatedClient,
-) -> Response[Union[HTTPValidationError, OrgLimitsResponse]]:
+) -> Response[HTTPValidationError | OrgLimitsResponse]:
   """Get Organization Limits
 
    Get the current limits and quotas for an organization.
@@ -68,7 +68,7 @@ def sync_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[HTTPValidationError, OrgLimitsResponse]]
+      Response[HTTPValidationError | OrgLimitsResponse]
   """
 
   kwargs = _get_kwargs(
@@ -86,7 +86,7 @@ def sync(
   org_id: str,
   *,
   client: AuthenticatedClient,
-) -> Optional[Union[HTTPValidationError, OrgLimitsResponse]]:
+) -> HTTPValidationError | OrgLimitsResponse | None:
   """Get Organization Limits
 
    Get the current limits and quotas for an organization.
@@ -99,7 +99,7 @@ def sync(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[HTTPValidationError, OrgLimitsResponse]
+      HTTPValidationError | OrgLimitsResponse
   """
 
   return sync_detailed(
@@ -112,7 +112,7 @@ async def asyncio_detailed(
   org_id: str,
   *,
   client: AuthenticatedClient,
-) -> Response[Union[HTTPValidationError, OrgLimitsResponse]]:
+) -> Response[HTTPValidationError | OrgLimitsResponse]:
   """Get Organization Limits
 
    Get the current limits and quotas for an organization.
@@ -125,7 +125,7 @@ async def asyncio_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[HTTPValidationError, OrgLimitsResponse]]
+      Response[HTTPValidationError | OrgLimitsResponse]
   """
 
   kwargs = _get_kwargs(
@@ -141,7 +141,7 @@ async def asyncio(
   org_id: str,
   *,
   client: AuthenticatedClient,
-) -> Optional[Union[HTTPValidationError, OrgLimitsResponse]]:
+) -> HTTPValidationError | OrgLimitsResponse | None:
   """Get Organization Limits
 
    Get the current limits and quotas for an organization.
@@ -154,7 +154,7 @@ async def asyncio(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[HTTPValidationError, OrgLimitsResponse]
+      HTTPValidationError | OrgLimitsResponse
   """
 
   return (

robosystems_client/api/org_usage/get_org_usage.py

@@ -1,5 +1,5 @@
 from http import HTTPStatus
-from typing import Any, Optional, Union
+from typing import Any
 
 import httpx
 
@@ -13,7 +13,7 @@ from ...types import UNSET, Response, Unset
 def _get_kwargs(
   org_id: str,
   *,
-  days: Union[Unset, int] = 30,
+  days: int | Unset = 30,
 ) -> dict[str, Any]:
   params: dict[str, Any] = {}
 
@@ -31,8 +31,8 @@ def _get_kwargs(
 
 
 def _parse_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[HTTPValidationError, OrgUsageResponse]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> HTTPValidationError | OrgUsageResponse | None:
   if response.status_code == 200:
     response_200 = OrgUsageResponse.from_dict(response.json())
 
@@ -50,8 +50,8 @@ def _parse_response(
 
 
 def _build_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[HTTPValidationError, OrgUsageResponse]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[HTTPValidationError | OrgUsageResponse]:
   return Response(
     status_code=HTTPStatus(response.status_code),
     content=response.content,
@@ -64,22 +64,22 @@ def sync_detailed(
   org_id: str,
   *,
   client: AuthenticatedClient,
-  days: Union[Unset, int] = 30,
-) -> Response[Union[HTTPValidationError, OrgUsageResponse]]:
+  days: int | Unset = 30,
+) -> Response[HTTPValidationError | OrgUsageResponse]:
   """Get Organization Usage
 
    Get detailed usage statistics for an organization aggregated across all graphs.
 
   Args:
       org_id (str):
-      days (Union[Unset, int]):  Default: 30.
+      days (int | Unset):  Default: 30.
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[HTTPValidationError, OrgUsageResponse]]
+      Response[HTTPValidationError | OrgUsageResponse]
   """
 
   kwargs = _get_kwargs(
@@ -98,22 +98,22 @@ def sync(
   org_id: str,
   *,
   client: AuthenticatedClient,
-  days: Union[Unset, int] = 30,
-) -> Optional[Union[HTTPValidationError, OrgUsageResponse]]:
+  days: int | Unset = 30,
+) -> HTTPValidationError | OrgUsageResponse | None:
   """Get Organization Usage
 
    Get detailed usage statistics for an organization aggregated across all graphs.
 
   Args:
       org_id (str):
-      days (Union[Unset, int]):  Default: 30.
+      days (int | Unset):  Default: 30.
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[HTTPValidationError, OrgUsageResponse]
+      HTTPValidationError | OrgUsageResponse
   """
 
   return sync_detailed(
@@ -127,22 +127,22 @@ async def asyncio_detailed(
   org_id: str,
   *,
   client: AuthenticatedClient,
-  days: Union[Unset, int] = 30,
-) -> Response[Union[HTTPValidationError, OrgUsageResponse]]:
+  days: int | Unset = 30,
+) -> Response[HTTPValidationError | OrgUsageResponse]:
   """Get Organization Usage
 
    Get detailed usage statistics for an organization aggregated across all graphs.
 
   Args:
       org_id (str):
-      days (Union[Unset, int]):  Default: 30.
+      days (int | Unset):  Default: 30.
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[HTTPValidationError, OrgUsageResponse]]
+      Response[HTTPValidationError | OrgUsageResponse]
   """
 
   kwargs = _get_kwargs(
@@ -159,22 +159,22 @@ async def asyncio(
   org_id: str,
   *,
   client: AuthenticatedClient,
-  days: Union[Unset, int] = 30,
-) -> Optional[Union[HTTPValidationError, OrgUsageResponse]]:
+  days: int | Unset = 30,
+) -> HTTPValidationError | OrgUsageResponse | None:
   """Get Organization Usage
 
    Get detailed usage statistics for an organization aggregated across all graphs.
 
   Args:
       org_id (str):
-      days (Union[Unset, int]):  Default: 30.
+      days (int | Unset):  Default: 30.
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[HTTPValidationError, OrgUsageResponse]
+      HTTPValidationError | OrgUsageResponse
   """
 
   return (

robosystems_client/api/query/execute_cypher_query.py

@@ -1,5 +1,5 @@
 from http import HTTPStatus
-from typing import Any, Optional, Union, cast
+from typing import Any, cast
 
 import httpx
 
@@ -16,15 +16,15 @@ def _get_kwargs(
   graph_id: str,
   *,
   body: CypherQueryRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-  chunk_size: Union[None, Unset, int] = UNSET,
-  test_mode: Union[Unset, bool] = False,
+  mode: None | ResponseMode | Unset = UNSET,
+  chunk_size: int | None | Unset = UNSET,
+  test_mode: bool | Unset = False,
 ) -> dict[str, Any]:
   headers: dict[str, Any] = {}
 
   params: dict[str, Any] = {}
 
-  json_mode: Union[None, Unset, str]
+  json_mode: None | str | Unset
   if isinstance(mode, Unset):
     json_mode = UNSET
   elif isinstance(mode, ResponseMode):
@@ -33,7 +33,7 @@ def _get_kwargs(
     json_mode = mode
   params["mode"] = json_mode
 
-  json_chunk_size: Union[None, Unset, int]
+  json_chunk_size: int | None | Unset
   if isinstance(chunk_size, Unset):
     json_chunk_size = UNSET
   else:
@@ -59,8 +59,8 @@ def _get_kwargs(
 
 
 def _parse_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Any | ExecuteCypherQueryResponse200 | HTTPValidationError | None:
   if response.status_code == 200:
     content_type = response.headers.get("content-type", "")
     if (
@@ -112,8 +112,8 @@ def _parse_response(
 
 
 def _build_response(
-  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]]:
+  *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[Any | ExecuteCypherQueryResponse200 | HTTPValidationError]:
   return Response(
     status_code=HTTPStatus(response.status_code),
     content=response.content,
@@ -127,17 +127,20 @@ def sync_detailed(
   *,
   client: AuthenticatedClient,
   body: CypherQueryRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-  chunk_size: Union[None, Unset, int] = UNSET,
-  test_mode: Union[Unset, bool] = False,
-) -> Response[Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]]:
-  r"""Execute Cypher Query (Read-Only)
+  mode: None | ResponseMode | Unset = UNSET,
+  chunk_size: int | None | Unset = UNSET,
+  test_mode: bool | Unset = False,
+) -> Response[Any | ExecuteCypherQueryResponse200 | HTTPValidationError]:
+  r"""Execute Cypher Query
 
-   Execute a read-only Cypher query with intelligent response optimization.
+   Execute a Cypher query with intelligent response optimization.
 
-  **IMPORTANT: This endpoint is READ-ONLY.** Write operations (CREATE, MERGE, SET, DELETE) are not
-  allowed.
-  To load data into your graph, use the staging pipeline:
+  **IMPORTANT: Write operations depend on graph type:**
+  - **Main Graphs**: READ-ONLY. Write operations (CREATE, MERGE, SET, DELETE) are not allowed.
+  - **Subgraphs**: WRITE-ENABLED. Full Cypher write operations are supported for development and
+  report creation.
+
+  To load data into main graphs, use the staging pipeline:
   1. Create file upload: `POST /v1/graphs/{graph_id}/tables/{table_name}/files`
   2. Ingest to graph: `POST /v1/graphs/{graph_id}/tables/ingest`
 
@@ -193,15 +196,21 @@ def sync_detailed(
   - `503 Service Unavailable`: Circuit breaker open or SSE disabled
   - Clients should implement exponential backoff
 
+  **Subgraph Support:**
+  This endpoint accepts both parent graph IDs and subgraph IDs.
+  - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+  - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+  Subgraphs share the same instance as their parent graph and have independent data.
+
   **Note:**
   Query operations are included - no credit consumption required.
   Queue position is based on subscription tier for priority.
 
   Args:
       graph_id (str):
-      mode (Union[None, ResponseMode, Unset]): Response mode override
-      chunk_size (Union[None, Unset, int]): Rows per chunk for streaming
-      test_mode (Union[Unset, bool]): Enable test mode for better debugging Default: False.
+      mode (None | ResponseMode | Unset): Response mode override
+      chunk_size (int | None | Unset): Rows per chunk for streaming
+      test_mode (bool | Unset): Enable test mode for better debugging Default: False.
       body (CypherQueryRequest): Request model for Cypher query execution.
 
   Raises:
@@ -209,7 +218,7 @@ def sync_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]]
+      Response[Any | ExecuteCypherQueryResponse200 | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -232,17 +241,20 @@ def sync(
   *,
   client: AuthenticatedClient,
   body: CypherQueryRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-  chunk_size: Union[None, Unset, int] = UNSET,
-  test_mode: Union[Unset, bool] = False,
-) -> Optional[Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]]:
-  r"""Execute Cypher Query (Read-Only)
+  mode: None | ResponseMode | Unset = UNSET,
+  chunk_size: int | None | Unset = UNSET,
+  test_mode: bool | Unset = False,
+) -> Any | ExecuteCypherQueryResponse200 | HTTPValidationError | None:
+  r"""Execute Cypher Query
 
-   Execute a read-only Cypher query with intelligent response optimization.
+   Execute a Cypher query with intelligent response optimization.
 
-  **IMPORTANT: This endpoint is READ-ONLY.** Write operations (CREATE, MERGE, SET, DELETE) are not
-  allowed.
-  To load data into your graph, use the staging pipeline:
+  **IMPORTANT: Write operations depend on graph type:**
+  - **Main Graphs**: READ-ONLY. Write operations (CREATE, MERGE, SET, DELETE) are not allowed.
+  - **Subgraphs**: WRITE-ENABLED. Full Cypher write operations are supported for development and
+  report creation.
+
+  To load data into main graphs, use the staging pipeline:
   1. Create file upload: `POST /v1/graphs/{graph_id}/tables/{table_name}/files`
   2. Ingest to graph: `POST /v1/graphs/{graph_id}/tables/ingest`
 
@@ -298,15 +310,21 @@ def sync(
   - `503 Service Unavailable`: Circuit breaker open or SSE disabled
   - Clients should implement exponential backoff
 
+  **Subgraph Support:**
+  This endpoint accepts both parent graph IDs and subgraph IDs.
+  - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+  - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+  Subgraphs share the same instance as their parent graph and have independent data.
+
   **Note:**
   Query operations are included - no credit consumption required.
   Queue position is based on subscription tier for priority.
 
   Args:
       graph_id (str):
-      mode (Union[None, ResponseMode, Unset]): Response mode override
-      chunk_size (Union[None, Unset, int]): Rows per chunk for streaming
-      test_mode (Union[Unset, bool]): Enable test mode for better debugging Default: False.
+      mode (None | ResponseMode | Unset): Response mode override
+      chunk_size (int | None | Unset): Rows per chunk for streaming
+      test_mode (bool | Unset): Enable test mode for better debugging Default: False.
       body (CypherQueryRequest): Request model for Cypher query execution.
 
   Raises:
@@ -314,7 +332,7 @@ def sync(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]
+      Any | ExecuteCypherQueryResponse200 | HTTPValidationError
   """
 
   return sync_detailed(
@@ -332,17 +350,20 @@ async def asyncio_detailed(
   *,
   client: AuthenticatedClient,
   body: CypherQueryRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-  chunk_size: Union[None, Unset, int] = UNSET,
-  test_mode: Union[Unset, bool] = False,
-) -> Response[Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]]:
-  r"""Execute Cypher Query (Read-Only)
+  mode: None | ResponseMode | Unset = UNSET,
+  chunk_size: int | None | Unset = UNSET,
+  test_mode: bool | Unset = False,
+) -> Response[Any | ExecuteCypherQueryResponse200 | HTTPValidationError]:
+  r"""Execute Cypher Query
 
-   Execute a read-only Cypher query with intelligent response optimization.
+   Execute a Cypher query with intelligent response optimization.
 
-  **IMPORTANT: This endpoint is READ-ONLY.** Write operations (CREATE, MERGE, SET, DELETE) are not
-  allowed.
-  To load data into your graph, use the staging pipeline:
+  **IMPORTANT: Write operations depend on graph type:**
+  - **Main Graphs**: READ-ONLY. Write operations (CREATE, MERGE, SET, DELETE) are not allowed.
+  - **Subgraphs**: WRITE-ENABLED. Full Cypher write operations are supported for development and
+  report creation.
+
+  To load data into main graphs, use the staging pipeline:
   1. Create file upload: `POST /v1/graphs/{graph_id}/tables/{table_name}/files`
   2. Ingest to graph: `POST /v1/graphs/{graph_id}/tables/ingest`
 
@@ -398,15 +419,21 @@ async def asyncio_detailed(
   - `503 Service Unavailable`: Circuit breaker open or SSE disabled
   - Clients should implement exponential backoff
 
+  **Subgraph Support:**
+  This endpoint accepts both parent graph IDs and subgraph IDs.
+  - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+  - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+  Subgraphs share the same instance as their parent graph and have independent data.
+
   **Note:**
   Query operations are included - no credit consumption required.
   Queue position is based on subscription tier for priority.
 
   Args:
       graph_id (str):
-      mode (Union[None, ResponseMode, Unset]): Response mode override
-      chunk_size (Union[None, Unset, int]): Rows per chunk for streaming
-      test_mode (Union[Unset, bool]): Enable test mode for better debugging Default: False.
+      mode (None | ResponseMode | Unset): Response mode override
+      chunk_size (int | None | Unset): Rows per chunk for streaming
+      test_mode (bool | Unset): Enable test mode for better debugging Default: False.
       body (CypherQueryRequest): Request model for Cypher query execution.
 
   Raises:
@@ -414,7 +441,7 @@ async def asyncio_detailed(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Response[Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]]
+      Response[Any | ExecuteCypherQueryResponse200 | HTTPValidationError]
   """
 
   kwargs = _get_kwargs(
@@ -435,17 +462,20 @@ async def asyncio(
   *,
   client: AuthenticatedClient,
   body: CypherQueryRequest,
-  mode: Union[None, ResponseMode, Unset] = UNSET,
-  chunk_size: Union[None, Unset, int] = UNSET,
-  test_mode: Union[Unset, bool] = False,
-) -> Optional[Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]]:
-  r"""Execute Cypher Query (Read-Only)
+  mode: None | ResponseMode | Unset = UNSET,
+  chunk_size: int | None | Unset = UNSET,
+  test_mode: bool | Unset = False,
+) -> Any | ExecuteCypherQueryResponse200 | HTTPValidationError | None:
+  r"""Execute Cypher Query
 
-   Execute a read-only Cypher query with intelligent response optimization.
+   Execute a Cypher query with intelligent response optimization.
 
-  **IMPORTANT: This endpoint is READ-ONLY.** Write operations (CREATE, MERGE, SET, DELETE) are not
-  allowed.
-  To load data into your graph, use the staging pipeline:
+  **IMPORTANT: Write operations depend on graph type:**
+  - **Main Graphs**: READ-ONLY. Write operations (CREATE, MERGE, SET, DELETE) are not allowed.
+  - **Subgraphs**: WRITE-ENABLED. Full Cypher write operations are supported for development and
+  report creation.
+
+  To load data into main graphs, use the staging pipeline:
   1. Create file upload: `POST /v1/graphs/{graph_id}/tables/{table_name}/files`
   2. Ingest to graph: `POST /v1/graphs/{graph_id}/tables/ingest`
 
@@ -501,15 +531,21 @@ async def asyncio(
   - `503 Service Unavailable`: Circuit breaker open or SSE disabled
   - Clients should implement exponential backoff
 
+  **Subgraph Support:**
+  This endpoint accepts both parent graph IDs and subgraph IDs.
+  - Parent graph: Use `graph_id` like `kg0123456789abcdef`
+  - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
+  Subgraphs share the same instance as their parent graph and have independent data.
+
   **Note:**
   Query operations are included - no credit consumption required.
   Queue position is based on subscription tier for priority.
 
   Args:
       graph_id (str):
-      mode (Union[None, ResponseMode, Unset]): Response mode override
-      chunk_size (Union[None, Unset, int]): Rows per chunk for streaming
-      test_mode (Union[Unset, bool]): Enable test mode for better debugging Default: False.
+      mode (None | ResponseMode | Unset): Response mode override
+      chunk_size (int | None | Unset): Rows per chunk for streaming
+      test_mode (bool | Unset): Enable test mode for better debugging Default: False.
       body (CypherQueryRequest): Request model for Cypher query execution.
 
   Raises:
@@ -517,7 +553,7 @@ async def asyncio(
       httpx.TimeoutException: If the request takes longer than Client.timeout.
 
   Returns:
-      Union[Any, ExecuteCypherQueryResponse200, HTTPValidationError]
+      Any | ExecuteCypherQueryResponse200 | HTTPValidationError
   """
 
   return (