robosystems-client 0.2.13__py3-none-any.whl → 0.2.15__py3-none-any.whl

robosystems_client/api/schema/validate_schema.py

@@ -105,6 +105,13 @@ def sync_detailed(
   - Performance problems
   - Naming conflicts
 
+  **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`
+  Schema validation is performed against the specified graph/subgraph's current
+  schema and data structure.
+
   This operation is included - no credit consumption required.
 
   Args:
@@ -160,6 +167,13 @@ def sync(
   - Performance problems
   - Naming conflicts
 
+  **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`
+  Schema validation is performed against the specified graph/subgraph's current
+  schema and data structure.
+
   This operation is included - no credit consumption required.
 
   Args:
@@ -210,6 +224,13 @@ async def asyncio_detailed(
   - Performance problems
   - Naming conflicts
 
+  **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`
+  Schema validation is performed against the specified graph/subgraph's current
+  schema and data structure.
+
   This operation is included - no credit consumption required.
 
   Args:
@@ -263,6 +284,13 @@ async def asyncio(
   - Performance problems
   - Naming conflicts
 
+  **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`
+  Schema validation is performed against the specified graph/subgraph's current
+  schema and data structure.
+
   This operation is included - no credit consumption required.
 
   Args:

robosystems_client/api/subgraphs/create_subgraph.py

@@ -75,12 +75,18 @@ def sync_detailed(
   - Valid authentication
   - Parent graph must exist and be accessible to the user
   - User must have 'admin' permission on the parent graph
-  - Parent graph tier must support subgraphs (Enterprise or Premium only)
+  - Parent graph tier must support subgraphs (Kuzu Large/XLarge or Neo4j Enterprise XLarge)
   - Must be within subgraph quota limits
   - Subgraph name must be unique within the parent graph
 
   **Returns:**
   - Created subgraph details including its unique ID
+  - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
+
+  **Usage:**
+  - Subgraphs share parent's credit pool
+  - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}/*` endpoints
+  - Permissions inherited from parent graph
 
   Args:
       graph_id (str):
@@ -120,12 +126,18 @@ def sync(
   - Valid authentication
   - Parent graph must exist and be accessible to the user
   - User must have 'admin' permission on the parent graph
-  - Parent graph tier must support subgraphs (Enterprise or Premium only)
+  - Parent graph tier must support subgraphs (Kuzu Large/XLarge or Neo4j Enterprise XLarge)
   - Must be within subgraph quota limits
   - Subgraph name must be unique within the parent graph
 
   **Returns:**
   - Created subgraph details including its unique ID
+  - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
+
+  **Usage:**
+  - Subgraphs share parent's credit pool
+  - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}/*` endpoints
+  - Permissions inherited from parent graph
 
   Args:
       graph_id (str):
@@ -160,12 +172,18 @@ async def asyncio_detailed(
   - Valid authentication
   - Parent graph must exist and be accessible to the user
   - User must have 'admin' permission on the parent graph
-  - Parent graph tier must support subgraphs (Enterprise or Premium only)
+  - Parent graph tier must support subgraphs (Kuzu Large/XLarge or Neo4j Enterprise XLarge)
   - Must be within subgraph quota limits
   - Subgraph name must be unique within the parent graph
 
   **Returns:**
   - Created subgraph details including its unique ID
+  - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
+
+  **Usage:**
+  - Subgraphs share parent's credit pool
+  - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}/*` endpoints
+  - Permissions inherited from parent graph
 
   Args:
       graph_id (str):
@@ -203,12 +221,18 @@ async def asyncio(
   - Valid authentication
   - Parent graph must exist and be accessible to the user
   - User must have 'admin' permission on the parent graph
-  - Parent graph tier must support subgraphs (Enterprise or Premium only)
+  - Parent graph tier must support subgraphs (Kuzu Large/XLarge or Neo4j Enterprise XLarge)
   - Must be within subgraph quota limits
   - Subgraph name must be unique within the parent graph
 
   **Returns:**
   - Created subgraph details including its unique ID
+  - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
+
+  **Usage:**
+  - Subgraphs share parent's credit pool
+  - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}/*` endpoints
+  - Permissions inherited from parent graph
 
   Args:
       graph_id (str):

robosystems_client/api/subgraphs/delete_subgraph.py

@@ -13,7 +13,7 @@ from ...types import Response
 
 def _get_kwargs(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
   *,
   body: DeleteSubgraphRequest,
 ) -> dict[str, Any]:
@@ -21,7 +21,7 @@ def _get_kwargs(
 
   _kwargs: dict[str, Any] = {
     "method": "delete",
-    "url": f"/v1/graphs/{graph_id}/subgraphs/{subgraph_id}",
+    "url": f"/v1/graphs/{graph_id}/subgraphs/{subgraph_name}",
   }
 
   _kwargs["json"] = body.to_dict()
@@ -88,7 +88,7 @@ def _build_response(
 
 def sync_detailed(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
   *,
   client: AuthenticatedClient,
   body: DeleteSubgraphRequest,
@@ -100,6 +100,7 @@ def sync_detailed(
   **Requirements:**
   - Must be a valid subgraph (not parent graph)
   - User must have admin access to parent graph
+  - Subgraph name must be alphanumeric (1-20 characters)
   - Optional backup before deletion
 
   **Deletion Options:**
@@ -111,12 +112,17 @@ def sync_detailed(
   All data in the subgraph will be lost.
 
   **Backup Location:**
-  If backup requested, stored in S3 at:
-  `s3://robosystems-backups/{instance_id}/{database_name}_{timestamp}.backup`
+  If backup requested, stored in S3 Kuzu database bucket at:
+  `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
+
+  **Notes:**
+  - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
+  - Deletion does not affect parent graph's credit pool or permissions
+  - Backup creation consumes credits from parent graph's allocation
 
   Args:
       graph_id (str):
-      subgraph_id (str): Subgraph identifier to delete
+      subgraph_name (str): Subgraph name to delete (e.g., 'dev', 'staging')
       body (DeleteSubgraphRequest): Request model for deleting a subgraph.
 
   Raises:
@@ -129,7 +135,7 @@ def sync_detailed(
 
   kwargs = _get_kwargs(
     graph_id=graph_id,
-    subgraph_id=subgraph_id,
+    subgraph_name=subgraph_name,
     body=body,
   )
 
@@ -142,7 +148,7 @@ def sync_detailed(
 
 def sync(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
   *,
   client: AuthenticatedClient,
   body: DeleteSubgraphRequest,
@@ -154,6 +160,7 @@ def sync(
   **Requirements:**
   - Must be a valid subgraph (not parent graph)
   - User must have admin access to parent graph
+  - Subgraph name must be alphanumeric (1-20 characters)
   - Optional backup before deletion
 
   **Deletion Options:**
@@ -165,12 +172,17 @@ def sync(
   All data in the subgraph will be lost.
 
   **Backup Location:**
-  If backup requested, stored in S3 at:
-  `s3://robosystems-backups/{instance_id}/{database_name}_{timestamp}.backup`
+  If backup requested, stored in S3 Kuzu database bucket at:
+  `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
+
+  **Notes:**
+  - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
+  - Deletion does not affect parent graph's credit pool or permissions
+  - Backup creation consumes credits from parent graph's allocation
 
   Args:
       graph_id (str):
-      subgraph_id (str): Subgraph identifier to delete
+      subgraph_name (str): Subgraph name to delete (e.g., 'dev', 'staging')
       body (DeleteSubgraphRequest): Request model for deleting a subgraph.
 
   Raises:
@@ -183,7 +195,7 @@ def sync(
 
   return sync_detailed(
     graph_id=graph_id,
-    subgraph_id=subgraph_id,
+    subgraph_name=subgraph_name,
     client=client,
     body=body,
   ).parsed
@@ -191,7 +203,7 @@ def sync(
 
 async def asyncio_detailed(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
   *,
   client: AuthenticatedClient,
   body: DeleteSubgraphRequest,
@@ -203,6 +215,7 @@ async def asyncio_detailed(
   **Requirements:**
   - Must be a valid subgraph (not parent graph)
   - User must have admin access to parent graph
+  - Subgraph name must be alphanumeric (1-20 characters)
   - Optional backup before deletion
 
   **Deletion Options:**
@@ -214,12 +227,17 @@ async def asyncio_detailed(
   All data in the subgraph will be lost.
 
   **Backup Location:**
-  If backup requested, stored in S3 at:
-  `s3://robosystems-backups/{instance_id}/{database_name}_{timestamp}.backup`
+  If backup requested, stored in S3 Kuzu database bucket at:
+  `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
+
+  **Notes:**
+  - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
+  - Deletion does not affect parent graph's credit pool or permissions
+  - Backup creation consumes credits from parent graph's allocation
 
   Args:
       graph_id (str):
-      subgraph_id (str): Subgraph identifier to delete
+      subgraph_name (str): Subgraph name to delete (e.g., 'dev', 'staging')
       body (DeleteSubgraphRequest): Request model for deleting a subgraph.
 
   Raises:
@@ -232,7 +250,7 @@ async def asyncio_detailed(
 
   kwargs = _get_kwargs(
     graph_id=graph_id,
-    subgraph_id=subgraph_id,
+    subgraph_name=subgraph_name,
     body=body,
   )
 
@@ -243,7 +261,7 @@ async def asyncio_detailed(
 
 async def asyncio(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
   *,
   client: AuthenticatedClient,
   body: DeleteSubgraphRequest,
@@ -255,6 +273,7 @@ async def asyncio(
   **Requirements:**
   - Must be a valid subgraph (not parent graph)
   - User must have admin access to parent graph
+  - Subgraph name must be alphanumeric (1-20 characters)
   - Optional backup before deletion
 
   **Deletion Options:**
@@ -266,12 +285,17 @@ async def asyncio(
   All data in the subgraph will be lost.
 
   **Backup Location:**
-  If backup requested, stored in S3 at:
-  `s3://robosystems-backups/{instance_id}/{database_name}_{timestamp}.backup`
+  If backup requested, stored in S3 Kuzu database bucket at:
+  `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
+
+  **Notes:**
+  - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
+  - Deletion does not affect parent graph's credit pool or permissions
+  - Backup creation consumes credits from parent graph's allocation
 
   Args:
       graph_id (str):
-      subgraph_id (str): Subgraph identifier to delete
+      subgraph_name (str): Subgraph name to delete (e.g., 'dev', 'staging')
       body (DeleteSubgraphRequest): Request model for deleting a subgraph.
 
   Raises:
@@ -285,7 +309,7 @@ async def asyncio(
   return (
     await asyncio_detailed(
       graph_id=graph_id,
-      subgraph_id=subgraph_id,
+      subgraph_name=subgraph_name,
       client=client,
       body=body,
     )

robosystems_client/api/subgraphs/get_subgraph_info.py

@@ -12,11 +12,11 @@ from ...types import Response
 
 def _get_kwargs(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
 ) -> dict[str, Any]:
   _kwargs: dict[str, Any] = {
     "method": "get",
-    "url": f"/v1/graphs/{graph_id}/subgraphs/{subgraph_id}/info",
+    "url": f"/v1/graphs/{graph_id}/subgraphs/{subgraph_name}/info",
   }
 
   return _kwargs
@@ -74,7 +74,7 @@ def _build_response(
 
 def sync_detailed(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
   *,
   client: AuthenticatedClient,
 ) -> Response[Union[Any, HTTPValidationError, SubgraphResponse]]:
@@ -84,6 +84,7 @@ def sync_detailed(
 
   **Requirements:**
   - User must have read access to parent graph
+  - Subgraph name must be alphanumeric (1-20 characters)
 
   **Response includes:**
   - Full subgraph metadata
@@ -100,9 +101,13 @@ def sync_detailed(
   - Database size on disk
   - Schema information
 
+  **Note:**
+  Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
+  The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
+
   Args:
       graph_id (str):
-      subgraph_id (str): Subgraph identifier
+      subgraph_name (str): Subgraph name (e.g., 'dev', 'staging')
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -114,7 +119,7 @@ def sync_detailed(
 
   kwargs = _get_kwargs(
     graph_id=graph_id,
-    subgraph_id=subgraph_id,
+    subgraph_name=subgraph_name,
   )
 
   response = client.get_httpx_client().request(
@@ -126,7 +131,7 @@ def sync_detailed(
 
 def sync(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
   *,
   client: AuthenticatedClient,
 ) -> Optional[Union[Any, HTTPValidationError, SubgraphResponse]]:
@@ -136,6 +141,7 @@ def sync(
 
   **Requirements:**
   - User must have read access to parent graph
+  - Subgraph name must be alphanumeric (1-20 characters)
 
   **Response includes:**
   - Full subgraph metadata
@@ -152,9 +158,13 @@ def sync(
   - Database size on disk
   - Schema information
 
+  **Note:**
+  Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
+  The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
+
   Args:
       graph_id (str):
-      subgraph_id (str): Subgraph identifier
+      subgraph_name (str): Subgraph name (e.g., 'dev', 'staging')
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -166,14 +176,14 @@ def sync(
 
   return sync_detailed(
     graph_id=graph_id,
-    subgraph_id=subgraph_id,
+    subgraph_name=subgraph_name,
     client=client,
   ).parsed
 
 
 async def asyncio_detailed(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
   *,
   client: AuthenticatedClient,
 ) -> Response[Union[Any, HTTPValidationError, SubgraphResponse]]:
@@ -183,6 +193,7 @@ async def asyncio_detailed(
 
   **Requirements:**
   - User must have read access to parent graph
+  - Subgraph name must be alphanumeric (1-20 characters)
 
   **Response includes:**
   - Full subgraph metadata
@@ -199,9 +210,13 @@ async def asyncio_detailed(
   - Database size on disk
   - Schema information
 
+  **Note:**
+  Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
+  The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
+
   Args:
       graph_id (str):
-      subgraph_id (str): Subgraph identifier
+      subgraph_name (str): Subgraph name (e.g., 'dev', 'staging')
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -213,7 +228,7 @@ async def asyncio_detailed(
 
   kwargs = _get_kwargs(
     graph_id=graph_id,
-    subgraph_id=subgraph_id,
+    subgraph_name=subgraph_name,
   )
 
   response = await client.get_async_httpx_client().request(**kwargs)
@@ -223,7 +238,7 @@ async def asyncio_detailed(
 
 async def asyncio(
   graph_id: str,
-  subgraph_id: str,
+  subgraph_name: str,
   *,
   client: AuthenticatedClient,
 ) -> Optional[Union[Any, HTTPValidationError, SubgraphResponse]]:
@@ -233,6 +248,7 @@ async def asyncio(
 
   **Requirements:**
   - User must have read access to parent graph
+  - Subgraph name must be alphanumeric (1-20 characters)
 
   **Response includes:**
   - Full subgraph metadata
@@ -249,9 +265,13 @@ async def asyncio(
   - Database size on disk
   - Schema information
 
+  **Note:**
+  Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
+  The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
+
   Args:
       graph_id (str):
-      subgraph_id (str): Subgraph identifier
+      subgraph_name (str): Subgraph name (e.g., 'dev', 'staging')
 
   Raises:
       errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -264,7 +284,7 @@ async def asyncio(
   return (
     await asyncio_detailed(
       graph_id=graph_id,
-      subgraph_id=subgraph_id,
+      subgraph_name=subgraph_name,
       client=client,
     )
   ).parsed

robosystems_client/api/tables/get_upload_url.py

@@ -123,6 +123,13 @@ def sync_detailed(
   Tables are automatically created on first file upload with type inferred from name
   (e.g., \"Transaction\" → relationship) and empty schema populated during ingestion.
 
+  **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`
+  Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
+  to one subgraph do not appear in other subgraphs.
+
   **Important Notes:**
   - Presigned URLs expire (default: 1 hour)
   - Use appropriate Content-Type header when uploading to S3
@@ -192,6 +199,13 @@ def sync(
   Tables are automatically created on first file upload with type inferred from name
   (e.g., \"Transaction\" → relationship) and empty schema populated during ingestion.
 
+  **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`
+  Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
+  to one subgraph do not appear in other subgraphs.
+
   **Important Notes:**
   - Presigned URLs expire (default: 1 hour)
   - Use appropriate Content-Type header when uploading to S3
@@ -256,6 +270,13 @@ async def asyncio_detailed(
   Tables are automatically created on first file upload with type inferred from name
   (e.g., \"Transaction\" → relationship) and empty schema populated during ingestion.
 
+  **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`
+  Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
+  to one subgraph do not appear in other subgraphs.
+
   **Important Notes:**
   - Presigned URLs expire (default: 1 hour)
   - Use appropriate Content-Type header when uploading to S3
@@ -323,6 +344,13 @@ async def asyncio(
   Tables are automatically created on first file upload with type inferred from name
   (e.g., \"Transaction\" → relationship) and empty schema populated during ingestion.
 
+  **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`
+  Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
+  to one subgraph do not appear in other subgraphs.
+
   **Important Notes:**
   - Presigned URLs expire (default: 1 hour)
   - Use appropriate Content-Type header when uploading to S3

robosystems_client/api/tables/ingest_tables.py

@@ -110,7 +110,7 @@ def sync_detailed(
   2. Files are validated and marked as 'uploaded'
   3. Trigger ingestion: `POST /tables/ingest`
   4. DuckDB staging tables created from S3 patterns
-  5. Data copied row-by-row from DuckDB to Kuzu
+  5. Data copied from DuckDB to Kuzu
   6. Per-table results and metrics returned
 
   **Rebuild Feature:**
@@ -141,6 +141,13 @@ def sync_detailed(
   you'll receive a 409 Conflict error. The distributed lock automatically expires after
   the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
 
+  **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`
+  Each subgraph has independent staging tables and graph data. Ingestion operates
+  on the specified graph/subgraph only and does not affect other subgraphs.
+
   **Important Notes:**
   - Only files with 'uploaded' status are processed
   - Tables with no uploaded files are skipped
@@ -198,7 +205,7 @@ def sync(
   2. Files are validated and marked as 'uploaded'
   3. Trigger ingestion: `POST /tables/ingest`
   4. DuckDB staging tables created from S3 patterns
-  5. Data copied row-by-row from DuckDB to Kuzu
+  5. Data copied from DuckDB to Kuzu
   6. Per-table results and metrics returned
 
   **Rebuild Feature:**
@@ -229,6 +236,13 @@ def sync(
   you'll receive a 409 Conflict error. The distributed lock automatically expires after
   the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
 
+  **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`
+  Each subgraph has independent staging tables and graph data. Ingestion operates
+  on the specified graph/subgraph only and does not affect other subgraphs.
+
   **Important Notes:**
   - Only files with 'uploaded' status are processed
   - Tables with no uploaded files are skipped
@@ -281,7 +295,7 @@ async def asyncio_detailed(
   2. Files are validated and marked as 'uploaded'
   3. Trigger ingestion: `POST /tables/ingest`
   4. DuckDB staging tables created from S3 patterns
-  5. Data copied row-by-row from DuckDB to Kuzu
+  5. Data copied from DuckDB to Kuzu
   6. Per-table results and metrics returned
 
   **Rebuild Feature:**
@@ -312,6 +326,13 @@ async def asyncio_detailed(
   you'll receive a 409 Conflict error. The distributed lock automatically expires after
   the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
 
+  **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`
+  Each subgraph has independent staging tables and graph data. Ingestion operates
+  on the specified graph/subgraph only and does not affect other subgraphs.
+
   **Important Notes:**
   - Only files with 'uploaded' status are processed
   - Tables with no uploaded files are skipped
@@ -367,7 +388,7 @@ async def asyncio(
   2. Files are validated and marked as 'uploaded'
   3. Trigger ingestion: `POST /tables/ingest`
   4. DuckDB staging tables created from S3 patterns
-  5. Data copied row-by-row from DuckDB to Kuzu
+  5. Data copied from DuckDB to Kuzu
   6. Per-table results and metrics returned
 
   **Rebuild Feature:**
@@ -398,6 +419,13 @@ async def asyncio(
   you'll receive a 409 Conflict error. The distributed lock automatically expires after
   the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
 
+  **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`
+  Each subgraph has independent staging tables and graph data. Ingestion operates
+  on the specified graph/subgraph only and does not affect other subgraphs.
+
   **Important Notes:**
   - Only files with 'uploaded' status are processed
   - Tables with no uploaded files are skipped