feat: enhance API documentation with comprehensive subgraph support

robosystems_client/api/agent/auto_select_agent.py

@@ -158,6 +158,13 @@ def sync_detailed(
   - Leverage conversation history for contextual understanding
   - Enable RAG for knowledge base enrichment
 
+  **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`
+  Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+  and knowledge base search are scoped to the specific graph/subgraph.
+
   See request/response examples in the \"Examples\" dropdown below.
 
   Args:
@@ -246,6 +253,13 @@ def sync(
   - Leverage conversation history for contextual understanding
   - Enable RAG for knowledge base enrichment
 
+  **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`
+  Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+  and knowledge base search are scoped to the specific graph/subgraph.
+
   See request/response examples in the \"Examples\" dropdown below.
 
   Args:
@@ -329,6 +343,13 @@ async def asyncio_detailed(
   - Leverage conversation history for contextual understanding
   - Enable RAG for knowledge base enrichment
 
+  **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`
+  Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+  and knowledge base search are scoped to the specific graph/subgraph.
+
   See request/response examples in the \"Examples\" dropdown below.
 
   Args:
@@ -415,6 +436,13 @@ async def asyncio(
   - Leverage conversation history for contextual understanding
   - Enable RAG for knowledge base enrichment
 
+  **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`
+  Agents operate on the specified graph/subgraph's data independently. RAG enrichment
+  and knowledge base search are scoped to the specific graph/subgraph.
+
   See request/response examples in the \"Examples\" dropdown below.
 
   Args:

robosystems_client/api/graph_health/get_database_health.py

@@ -86,6 +86,13 @@ def sync_detailed(
   - **Resource Usage**: Memory and storage consumption
   - **Alerts**: Active warnings or issues
 
+  **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`
+  Health metrics are specific to the requested graph/subgraph. Subgraphs share the
+  same physical instance as their parent but have independent health indicators.
+
   This endpoint provides essential monitoring data for operational visibility.
 
   Args:
@@ -133,6 +140,13 @@ def sync(
   - **Resource Usage**: Memory and storage consumption
   - **Alerts**: Active warnings or issues
 
+  **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`
+  Health metrics are specific to the requested graph/subgraph. Subgraphs share the
+  same physical instance as their parent but have independent health indicators.
+
   This endpoint provides essential monitoring data for operational visibility.
 
   Args:
@@ -175,6 +189,13 @@ async def asyncio_detailed(
   - **Resource Usage**: Memory and storage consumption
   - **Alerts**: Active warnings or issues
 
+  **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`
+  Health metrics are specific to the requested graph/subgraph. Subgraphs share the
+  same physical instance as their parent but have independent health indicators.
+
   This endpoint provides essential monitoring data for operational visibility.
 
   Args:
@@ -220,6 +241,13 @@ async def asyncio(
   - **Resource Usage**: Memory and storage consumption
   - **Alerts**: Active warnings or issues
 
+  **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`
+  Health metrics are specific to the requested graph/subgraph. Subgraphs share the
+  same physical instance as their parent but have independent health indicators.
+
   This endpoint provides essential monitoring data for operational visibility.
 
   Args:

robosystems_client/api/graph_info/get_database_info.py

@@ -87,6 +87,13 @@ def sync_detailed(
   - **Backup Status**: Backup availability and recency
   - **Timestamps**: Creation and modification dates
 
+  **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`
+  Returned metrics are specific to the requested graph/subgraph. Subgraphs have
+  independent size, node/relationship counts, and backup status.
+
   This endpoint provides essential database information for capacity planning and monitoring.
 
   Args:
@@ -135,6 +142,13 @@ def sync(
   - **Backup Status**: Backup availability and recency
   - **Timestamps**: Creation and modification dates
 
+  **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`
+  Returned metrics are specific to the requested graph/subgraph. Subgraphs have
+  independent size, node/relationship counts, and backup status.
+
   This endpoint provides essential database information for capacity planning and monitoring.
 
   Args:
@@ -178,6 +192,13 @@ async def asyncio_detailed(
   - **Backup Status**: Backup availability and recency
   - **Timestamps**: Creation and modification dates
 
+  **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`
+  Returned metrics are specific to the requested graph/subgraph. Subgraphs have
+  independent size, node/relationship counts, and backup status.
+
   This endpoint provides essential database information for capacity planning and monitoring.
 
   Args:
@@ -224,6 +245,13 @@ async def asyncio(
   - **Backup Status**: Backup availability and recency
   - **Timestamps**: Creation and modification dates
 
+  **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`
+  Returned metrics are specific to the requested graph/subgraph. Subgraphs have
+  independent size, node/relationship counts, and backup status.
+
   This endpoint provides essential database information for capacity planning and monitoring.
 
   Args:

robosystems_client/api/graph_limits/get_graph_limits.py

@@ -82,7 +82,7 @@ def sync_detailed(
 
   This unified endpoint provides all limits in one place for easier client integration.
 
-  **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
+  **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
 
   Args:
       graph_id (str):
@@ -125,7 +125,7 @@ def sync(
 
   This unified endpoint provides all limits in one place for easier client integration.
 
-  **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
+  **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
 
   Args:
       graph_id (str):
@@ -163,7 +163,7 @@ async def asyncio_detailed(
 
   This unified endpoint provides all limits in one place for easier client integration.
 
-  **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
+  **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
 
   Args:
       graph_id (str):
@@ -204,7 +204,7 @@ async def asyncio(
 
   This unified endpoint provides all limits in one place for easier client integration.
 
-  **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
+  **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
 
   Args:
       graph_id (str):

robosystems_client/api/mcp/call_mcp_tool.py

@@ -157,6 +157,13 @@ def sync_detailed(
   - `408 Request Timeout`: Tool execution exceeded timeout
   - Clients should implement exponential backoff on errors
 
+  **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`
+  MCP tools operate on the specified graph/subgraph independently. Each subgraph
+  has its own schema, data, and can be queried separately via MCP.
+
   **Credit Model:**
   MCP tool execution is included - no credit consumption required. Database
   operations (queries, schema inspection, analytics) are completely free.
@@ -233,6 +240,13 @@ def sync(
   - `408 Request Timeout`: Tool execution exceeded timeout
   - Clients should implement exponential backoff on errors
 
+  **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`
+  MCP tools operate on the specified graph/subgraph independently. Each subgraph
+  has its own schema, data, and can be queried separately via MCP.
+
   **Credit Model:**
   MCP tool execution is included - no credit consumption required. Database
   operations (queries, schema inspection, analytics) are completely free.
@@ -304,6 +318,13 @@ async def asyncio_detailed(
   - `408 Request Timeout`: Tool execution exceeded timeout
   - Clients should implement exponential backoff on errors
 
+  **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`
+  MCP tools operate on the specified graph/subgraph independently. Each subgraph
+  has its own schema, data, and can be queried separately via MCP.
+
   **Credit Model:**
   MCP tool execution is included - no credit consumption required. Database
   operations (queries, schema inspection, analytics) are completely free.
@@ -378,6 +399,13 @@ async def asyncio(
   - `408 Request Timeout`: Tool execution exceeded timeout
   - Clients should implement exponential backoff on errors
 
+  **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`
+  MCP tools operate on the specified graph/subgraph independently. Each subgraph
+  has its own schema, data, and can be queried separately via MCP.
+
   **Credit Model:**
   MCP tool execution is included - no credit consumption required. Database
   operations (queries, schema inspection, analytics) are completely free.

robosystems_client/api/mcp/list_mcp_tools.py

@@ -81,6 +81,13 @@ def sync_detailed(
   - User permissions and subscription tier
   - Backend capabilities (Kuzu, Neo4j, etc.)
 
+  **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`
+  The returned tool list is identical for parent graphs and subgraphs, as all
+  MCP tools work uniformly across graph boundaries.
+
   **Note:**
   MCP tool listing is included - no credit consumption required.
 
@@ -125,6 +132,13 @@ def sync(
   - User permissions and subscription tier
   - Backend capabilities (Kuzu, Neo4j, etc.)
 
+  **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`
+  The returned tool list is identical for parent graphs and subgraphs, as all
+  MCP tools work uniformly across graph boundaries.
+
   **Note:**
   MCP tool listing is included - no credit consumption required.
 
@@ -164,6 +178,13 @@ async def asyncio_detailed(
   - User permissions and subscription tier
   - Backend capabilities (Kuzu, Neo4j, etc.)
 
+  **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`
+  The returned tool list is identical for parent graphs and subgraphs, as all
+  MCP tools work uniformly across graph boundaries.
+
   **Note:**
   MCP tool listing is included - no credit consumption required.
 
@@ -206,6 +227,13 @@ async def asyncio(
   - User permissions and subscription tier
   - Backend capabilities (Kuzu, Neo4j, etc.)
 
+  **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`
+  The returned tool list is identical for parent graphs and subgraphs, as all
+  MCP tools work uniformly across graph boundaries.
+
   **Note:**
   MCP tool listing is included - no credit consumption required.
 

robosystems_client/api/query/execute_cypher_query.py

@@ -193,6 +193,12 @@ 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.
@@ -298,6 +304,12 @@ 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.
@@ -398,6 +410,12 @@ 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.
@@ -501,6 +519,12 @@ 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.