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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of robosystems-client might be problematic. Click here for more details.

Files changed (29) hide show
  1. robosystems_client/api/agent/auto_select_agent.py +28 -0
  2. robosystems_client/api/billing/{update_org_payment_method.py → create_portal_session.py} +57 -47
  3. robosystems_client/api/graph_health/get_database_health.py +28 -0
  4. robosystems_client/api/graph_info/get_database_info.py +28 -0
  5. robosystems_client/api/graph_limits/get_graph_limits.py +4 -4
  6. robosystems_client/api/mcp/call_mcp_tool.py +28 -0
  7. robosystems_client/api/mcp/list_mcp_tools.py +28 -0
  8. robosystems_client/api/query/execute_cypher_query.py +24 -0
  9. robosystems_client/api/schema/get_graph_schema.py +32 -0
  10. robosystems_client/api/schema/validate_schema.py +28 -0
  11. robosystems_client/api/subgraphs/create_subgraph.py +28 -4
  12. robosystems_client/api/subgraphs/delete_subgraph.py +46 -22
  13. robosystems_client/api/subgraphs/get_subgraph_info.py +34 -14
  14. robosystems_client/api/tables/get_upload_url.py +28 -0
  15. robosystems_client/api/tables/ingest_tables.py +32 -4
  16. robosystems_client/api/tables/query_tables.py +24 -0
  17. robosystems_client/models/__init__.py +2 -6
  18. robosystems_client/models/create_subgraph_request.py +5 -26
  19. robosystems_client/models/graph_subscription_response.py +21 -0
  20. robosystems_client/models/list_subgraphs_response.py +9 -0
  21. robosystems_client/models/payment_method.py +3 -3
  22. robosystems_client/models/{update_payment_method_request.py → portal_session_response.py} +12 -12
  23. {robosystems_client-0.2.13.dist-info → robosystems_client-0.2.15.dist-info}/METADATA +1 -1
  24. {robosystems_client-0.2.13.dist-info → robosystems_client-0.2.15.dist-info}/RECORD +26 -29
  25. robosystems_client/api/subscriptions/cancel_subscription.py +0 -193
  26. robosystems_client/models/cancellation_response.py +0 -76
  27. robosystems_client/models/update_payment_method_response.py +0 -74
  28. {robosystems_client-0.2.13.dist-info → robosystems_client-0.2.15.dist-info}/WHEEL +0 -0
  29. {robosystems_client-0.2.13.dist-info → robosystems_client-0.2.15.dist-info}/licenses/LICENSE +0 -0
@@ -158,6 +158,13 @@ def sync_detailed(
158
158
  - Leverage conversation history for contextual understanding
159
159
  - Enable RAG for knowledge base enrichment
160
160
 
161
+ **Subgraph Support:**
162
+ This endpoint accepts both parent graph IDs and subgraph IDs.
163
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
164
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
165
+ Agents operate on the specified graph/subgraph's data independently. RAG enrichment
166
+ and knowledge base search are scoped to the specific graph/subgraph.
167
+
161
168
  See request/response examples in the \"Examples\" dropdown below.
162
169
 
163
170
  Args:
@@ -246,6 +253,13 @@ def sync(
246
253
  - Leverage conversation history for contextual understanding
247
254
  - Enable RAG for knowledge base enrichment
248
255
 
256
+ **Subgraph Support:**
257
+ This endpoint accepts both parent graph IDs and subgraph IDs.
258
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
259
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
260
+ Agents operate on the specified graph/subgraph's data independently. RAG enrichment
261
+ and knowledge base search are scoped to the specific graph/subgraph.
262
+
249
263
  See request/response examples in the \"Examples\" dropdown below.
250
264
 
251
265
  Args:
@@ -329,6 +343,13 @@ async def asyncio_detailed(
329
343
  - Leverage conversation history for contextual understanding
330
344
  - Enable RAG for knowledge base enrichment
331
345
 
346
+ **Subgraph Support:**
347
+ This endpoint accepts both parent graph IDs and subgraph IDs.
348
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
349
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
350
+ Agents operate on the specified graph/subgraph's data independently. RAG enrichment
351
+ and knowledge base search are scoped to the specific graph/subgraph.
352
+
332
353
  See request/response examples in the \"Examples\" dropdown below.
333
354
 
334
355
  Args:
@@ -415,6 +436,13 @@ async def asyncio(
415
436
  - Leverage conversation history for contextual understanding
416
437
  - Enable RAG for knowledge base enrichment
417
438
 
439
+ **Subgraph Support:**
440
+ This endpoint accepts both parent graph IDs and subgraph IDs.
441
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
442
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
443
+ Agents operate on the specified graph/subgraph's data independently. RAG enrichment
444
+ and knowledge base search are scoped to the specific graph/subgraph.
445
+
418
446
  See request/response examples in the \"Examples\" dropdown below.
419
447
 
420
448
  Args:
@@ -6,36 +6,26 @@ import httpx
6
6
  from ... import errors
7
7
  from ...client import AuthenticatedClient, Client
8
8
  from ...models.http_validation_error import HTTPValidationError
9
- from ...models.update_payment_method_request import UpdatePaymentMethodRequest
10
- from ...models.update_payment_method_response import UpdatePaymentMethodResponse
9
+ from ...models.portal_session_response import PortalSessionResponse
11
10
  from ...types import Response
12
11
 
13
12
 
14
13
  def _get_kwargs(
15
14
  org_id: str,
16
- *,
17
- body: UpdatePaymentMethodRequest,
18
15
  ) -> dict[str, Any]:
19
- headers: dict[str, Any] = {}
20
-
21
16
  _kwargs: dict[str, Any] = {
22
17
  "method": "post",
23
- "url": f"/v1/billing/customer/{org_id}/payment-method",
18
+ "url": f"/v1/billing/customer/{org_id}/portal",
24
19
  }
25
20
 
26
- _kwargs["json"] = body.to_dict()
27
-
28
- headers["Content-Type"] = "application/json"
29
-
30
- _kwargs["headers"] = headers
31
21
  return _kwargs
32
22
 
33
23
 
34
24
  def _parse_response(
35
25
  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
36
- ) -> Optional[Union[HTTPValidationError, UpdatePaymentMethodResponse]]:
26
+ ) -> Optional[Union[HTTPValidationError, PortalSessionResponse]]:
37
27
  if response.status_code == 200:
38
- response_200 = UpdatePaymentMethodResponse.from_dict(response.json())
28
+ response_200 = PortalSessionResponse.from_dict(response.json())
39
29
 
40
30
  return response_200
41
31
 
@@ -52,7 +42,7 @@ def _parse_response(
52
42
 
53
43
  def _build_response(
54
44
  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
55
- ) -> Response[Union[HTTPValidationError, UpdatePaymentMethodResponse]]:
45
+ ) -> Response[Union[HTTPValidationError, PortalSessionResponse]]:
56
46
  return Response(
57
47
  status_code=HTTPStatus(response.status_code),
58
48
  content=response.content,
@@ -65,32 +55,37 @@ def sync_detailed(
65
55
  org_id: str,
66
56
  *,
67
57
  client: AuthenticatedClient,
68
- body: UpdatePaymentMethodRequest,
69
- ) -> Response[Union[HTTPValidationError, UpdatePaymentMethodResponse]]:
70
- """Update Organization Default Payment Method
58
+ ) -> Response[Union[HTTPValidationError, PortalSessionResponse]]:
59
+ """Create Customer Portal Session
71
60
 
72
- Update the default payment method for the organization.
61
+ Create a Stripe Customer Portal session for managing payment methods.
73
62
 
74
- This changes which payment method will be used for future subscription charges.
63
+ The portal allows users to:
64
+ - Add new payment methods
65
+ - Remove existing payment methods
66
+ - Update default payment method
67
+ - View billing history
68
+
69
+ The user will be redirected to Stripe's hosted portal page and returned to the billing page when
70
+ done.
75
71
 
76
72
  **Requirements:**
77
73
  - User must be an OWNER of the organization
74
+ - Organization must have a Stripe customer ID (i.e., has gone through checkout at least once)
78
75
 
79
76
  Args:
80
77
  org_id (str):
81
- body (UpdatePaymentMethodRequest): Request to update default payment method.
82
78
 
83
79
  Raises:
84
80
  errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
85
81
  httpx.TimeoutException: If the request takes longer than Client.timeout.
86
82
 
87
83
  Returns:
88
- Response[Union[HTTPValidationError, UpdatePaymentMethodResponse]]
84
+ Response[Union[HTTPValidationError, PortalSessionResponse]]
89
85
  """
90
86
 
91
87
  kwargs = _get_kwargs(
92
88
  org_id=org_id,
93
- body=body,
94
89
  )
95
90
 
96
91
  response = client.get_httpx_client().request(
@@ -104,33 +99,38 @@ def sync(
104
99
  org_id: str,
105
100
  *,
106
101
  client: AuthenticatedClient,
107
- body: UpdatePaymentMethodRequest,
108
- ) -> Optional[Union[HTTPValidationError, UpdatePaymentMethodResponse]]:
109
- """Update Organization Default Payment Method
102
+ ) -> Optional[Union[HTTPValidationError, PortalSessionResponse]]:
103
+ """Create Customer Portal Session
104
+
105
+ Create a Stripe Customer Portal session for managing payment methods.
110
106
 
111
- Update the default payment method for the organization.
107
+ The portal allows users to:
108
+ - Add new payment methods
109
+ - Remove existing payment methods
110
+ - Update default payment method
111
+ - View billing history
112
112
 
113
- This changes which payment method will be used for future subscription charges.
113
+ The user will be redirected to Stripe's hosted portal page and returned to the billing page when
114
+ done.
114
115
 
115
116
  **Requirements:**
116
117
  - User must be an OWNER of the organization
118
+ - Organization must have a Stripe customer ID (i.e., has gone through checkout at least once)
117
119
 
118
120
  Args:
119
121
  org_id (str):
120
- body (UpdatePaymentMethodRequest): Request to update default payment method.
121
122
 
122
123
  Raises:
123
124
  errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
124
125
  httpx.TimeoutException: If the request takes longer than Client.timeout.
125
126
 
126
127
  Returns:
127
- Union[HTTPValidationError, UpdatePaymentMethodResponse]
128
+ Union[HTTPValidationError, PortalSessionResponse]
128
129
  """
129
130
 
130
131
  return sync_detailed(
131
132
  org_id=org_id,
132
133
  client=client,
133
- body=body,
134
134
  ).parsed
135
135
 
136
136
 
@@ -138,32 +138,37 @@ async def asyncio_detailed(
138
138
  org_id: str,
139
139
  *,
140
140
  client: AuthenticatedClient,
141
- body: UpdatePaymentMethodRequest,
142
- ) -> Response[Union[HTTPValidationError, UpdatePaymentMethodResponse]]:
143
- """Update Organization Default Payment Method
141
+ ) -> Response[Union[HTTPValidationError, PortalSessionResponse]]:
142
+ """Create Customer Portal Session
144
143
 
145
- Update the default payment method for the organization.
144
+ Create a Stripe Customer Portal session for managing payment methods.
146
145
 
147
- This changes which payment method will be used for future subscription charges.
146
+ The portal allows users to:
147
+ - Add new payment methods
148
+ - Remove existing payment methods
149
+ - Update default payment method
150
+ - View billing history
151
+
152
+ The user will be redirected to Stripe's hosted portal page and returned to the billing page when
153
+ done.
148
154
 
149
155
  **Requirements:**
150
156
  - User must be an OWNER of the organization
157
+ - Organization must have a Stripe customer ID (i.e., has gone through checkout at least once)
151
158
 
152
159
  Args:
153
160
  org_id (str):
154
- body (UpdatePaymentMethodRequest): Request to update default payment method.
155
161
 
156
162
  Raises:
157
163
  errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
158
164
  httpx.TimeoutException: If the request takes longer than Client.timeout.
159
165
 
160
166
  Returns:
161
- Response[Union[HTTPValidationError, UpdatePaymentMethodResponse]]
167
+ Response[Union[HTTPValidationError, PortalSessionResponse]]
162
168
  """
163
169
 
164
170
  kwargs = _get_kwargs(
165
171
  org_id=org_id,
166
- body=body,
167
172
  )
168
173
 
169
174
  response = await client.get_async_httpx_client().request(**kwargs)
@@ -175,33 +180,38 @@ async def asyncio(
175
180
  org_id: str,
176
181
  *,
177
182
  client: AuthenticatedClient,
178
- body: UpdatePaymentMethodRequest,
179
- ) -> Optional[Union[HTTPValidationError, UpdatePaymentMethodResponse]]:
180
- """Update Organization Default Payment Method
183
+ ) -> Optional[Union[HTTPValidationError, PortalSessionResponse]]:
184
+ """Create Customer Portal Session
185
+
186
+ Create a Stripe Customer Portal session for managing payment methods.
181
187
 
182
- Update the default payment method for the organization.
188
+ The portal allows users to:
189
+ - Add new payment methods
190
+ - Remove existing payment methods
191
+ - Update default payment method
192
+ - View billing history
183
193
 
184
- This changes which payment method will be used for future subscription charges.
194
+ The user will be redirected to Stripe's hosted portal page and returned to the billing page when
195
+ done.
185
196
 
186
197
  **Requirements:**
187
198
  - User must be an OWNER of the organization
199
+ - Organization must have a Stripe customer ID (i.e., has gone through checkout at least once)
188
200
 
189
201
  Args:
190
202
  org_id (str):
191
- body (UpdatePaymentMethodRequest): Request to update default payment method.
192
203
 
193
204
  Raises:
194
205
  errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
195
206
  httpx.TimeoutException: If the request takes longer than Client.timeout.
196
207
 
197
208
  Returns:
198
- Union[HTTPValidationError, UpdatePaymentMethodResponse]
209
+ Union[HTTPValidationError, PortalSessionResponse]
199
210
  """
200
211
 
201
212
  return (
202
213
  await asyncio_detailed(
203
214
  org_id=org_id,
204
215
  client=client,
205
- body=body,
206
216
  )
207
217
  ).parsed
@@ -86,6 +86,13 @@ def sync_detailed(
86
86
  - **Resource Usage**: Memory and storage consumption
87
87
  - **Alerts**: Active warnings or issues
88
88
 
89
+ **Subgraph Support:**
90
+ This endpoint accepts both parent graph IDs and subgraph IDs.
91
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
92
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
93
+ Health metrics are specific to the requested graph/subgraph. Subgraphs share the
94
+ same physical instance as their parent but have independent health indicators.
95
+
89
96
  This endpoint provides essential monitoring data for operational visibility.
90
97
 
91
98
  Args:
@@ -133,6 +140,13 @@ def sync(
133
140
  - **Resource Usage**: Memory and storage consumption
134
141
  - **Alerts**: Active warnings or issues
135
142
 
143
+ **Subgraph Support:**
144
+ This endpoint accepts both parent graph IDs and subgraph IDs.
145
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
146
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
147
+ Health metrics are specific to the requested graph/subgraph. Subgraphs share the
148
+ same physical instance as their parent but have independent health indicators.
149
+
136
150
  This endpoint provides essential monitoring data for operational visibility.
137
151
 
138
152
  Args:
@@ -175,6 +189,13 @@ async def asyncio_detailed(
175
189
  - **Resource Usage**: Memory and storage consumption
176
190
  - **Alerts**: Active warnings or issues
177
191
 
192
+ **Subgraph Support:**
193
+ This endpoint accepts both parent graph IDs and subgraph IDs.
194
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
195
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
196
+ Health metrics are specific to the requested graph/subgraph. Subgraphs share the
197
+ same physical instance as their parent but have independent health indicators.
198
+
178
199
  This endpoint provides essential monitoring data for operational visibility.
179
200
 
180
201
  Args:
@@ -220,6 +241,13 @@ async def asyncio(
220
241
  - **Resource Usage**: Memory and storage consumption
221
242
  - **Alerts**: Active warnings or issues
222
243
 
244
+ **Subgraph Support:**
245
+ This endpoint accepts both parent graph IDs and subgraph IDs.
246
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
247
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
248
+ Health metrics are specific to the requested graph/subgraph. Subgraphs share the
249
+ same physical instance as their parent but have independent health indicators.
250
+
223
251
  This endpoint provides essential monitoring data for operational visibility.
224
252
 
225
253
  Args:
@@ -87,6 +87,13 @@ def sync_detailed(
87
87
  - **Backup Status**: Backup availability and recency
88
88
  - **Timestamps**: Creation and modification dates
89
89
 
90
+ **Subgraph Support:**
91
+ This endpoint accepts both parent graph IDs and subgraph IDs.
92
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
93
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
94
+ Returned metrics are specific to the requested graph/subgraph. Subgraphs have
95
+ independent size, node/relationship counts, and backup status.
96
+
90
97
  This endpoint provides essential database information for capacity planning and monitoring.
91
98
 
92
99
  Args:
@@ -135,6 +142,13 @@ def sync(
135
142
  - **Backup Status**: Backup availability and recency
136
143
  - **Timestamps**: Creation and modification dates
137
144
 
145
+ **Subgraph Support:**
146
+ This endpoint accepts both parent graph IDs and subgraph IDs.
147
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
148
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
149
+ Returned metrics are specific to the requested graph/subgraph. Subgraphs have
150
+ independent size, node/relationship counts, and backup status.
151
+
138
152
  This endpoint provides essential database information for capacity planning and monitoring.
139
153
 
140
154
  Args:
@@ -178,6 +192,13 @@ async def asyncio_detailed(
178
192
  - **Backup Status**: Backup availability and recency
179
193
  - **Timestamps**: Creation and modification dates
180
194
 
195
+ **Subgraph Support:**
196
+ This endpoint accepts both parent graph IDs and subgraph IDs.
197
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
198
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
199
+ Returned metrics are specific to the requested graph/subgraph. Subgraphs have
200
+ independent size, node/relationship counts, and backup status.
201
+
181
202
  This endpoint provides essential database information for capacity planning and monitoring.
182
203
 
183
204
  Args:
@@ -224,6 +245,13 @@ async def asyncio(
224
245
  - **Backup Status**: Backup availability and recency
225
246
  - **Timestamps**: Creation and modification dates
226
247
 
248
+ **Subgraph Support:**
249
+ This endpoint accepts both parent graph IDs and subgraph IDs.
250
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
251
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
252
+ Returned metrics are specific to the requested graph/subgraph. Subgraphs have
253
+ independent size, node/relationship counts, and backup status.
254
+
227
255
  This endpoint provides essential database information for capacity planning and monitoring.
228
256
 
229
257
  Args:
@@ -82,7 +82,7 @@ def sync_detailed(
82
82
 
83
83
  This unified endpoint provides all limits in one place for easier client integration.
84
84
 
85
- **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
85
+ **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
86
86
 
87
87
  Args:
88
88
  graph_id (str):
@@ -125,7 +125,7 @@ def sync(
125
125
 
126
126
  This unified endpoint provides all limits in one place for easier client integration.
127
127
 
128
- **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
128
+ **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
129
129
 
130
130
  Args:
131
131
  graph_id (str):
@@ -163,7 +163,7 @@ async def asyncio_detailed(
163
163
 
164
164
  This unified endpoint provides all limits in one place for easier client integration.
165
165
 
166
- **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
166
+ **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
167
167
 
168
168
  Args:
169
169
  graph_id (str):
@@ -204,7 +204,7 @@ async def asyncio(
204
204
 
205
205
  This unified endpoint provides all limits in one place for easier client integration.
206
206
 
207
- **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
207
+ **Note**: Limits vary based on subscription tier (kuzu-standard, kuzu-large, kuzu-xlarge).
208
208
 
209
209
  Args:
210
210
  graph_id (str):
@@ -157,6 +157,13 @@ def sync_detailed(
157
157
  - `408 Request Timeout`: Tool execution exceeded timeout
158
158
  - Clients should implement exponential backoff on errors
159
159
 
160
+ **Subgraph Support:**
161
+ This endpoint accepts both parent graph IDs and subgraph IDs.
162
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
163
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
164
+ MCP tools operate on the specified graph/subgraph independently. Each subgraph
165
+ has its own schema, data, and can be queried separately via MCP.
166
+
160
167
  **Credit Model:**
161
168
  MCP tool execution is included - no credit consumption required. Database
162
169
  operations (queries, schema inspection, analytics) are completely free.
@@ -233,6 +240,13 @@ def sync(
233
240
  - `408 Request Timeout`: Tool execution exceeded timeout
234
241
  - Clients should implement exponential backoff on errors
235
242
 
243
+ **Subgraph Support:**
244
+ This endpoint accepts both parent graph IDs and subgraph IDs.
245
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
246
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
247
+ MCP tools operate on the specified graph/subgraph independently. Each subgraph
248
+ has its own schema, data, and can be queried separately via MCP.
249
+
236
250
  **Credit Model:**
237
251
  MCP tool execution is included - no credit consumption required. Database
238
252
  operations (queries, schema inspection, analytics) are completely free.
@@ -304,6 +318,13 @@ async def asyncio_detailed(
304
318
  - `408 Request Timeout`: Tool execution exceeded timeout
305
319
  - Clients should implement exponential backoff on errors
306
320
 
321
+ **Subgraph Support:**
322
+ This endpoint accepts both parent graph IDs and subgraph IDs.
323
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
324
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
325
+ MCP tools operate on the specified graph/subgraph independently. Each subgraph
326
+ has its own schema, data, and can be queried separately via MCP.
327
+
307
328
  **Credit Model:**
308
329
  MCP tool execution is included - no credit consumption required. Database
309
330
  operations (queries, schema inspection, analytics) are completely free.
@@ -378,6 +399,13 @@ async def asyncio(
378
399
  - `408 Request Timeout`: Tool execution exceeded timeout
379
400
  - Clients should implement exponential backoff on errors
380
401
 
402
+ **Subgraph Support:**
403
+ This endpoint accepts both parent graph IDs and subgraph IDs.
404
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
405
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
406
+ MCP tools operate on the specified graph/subgraph independently. Each subgraph
407
+ has its own schema, data, and can be queried separately via MCP.
408
+
381
409
  **Credit Model:**
382
410
  MCP tool execution is included - no credit consumption required. Database
383
411
  operations (queries, schema inspection, analytics) are completely free.
@@ -81,6 +81,13 @@ def sync_detailed(
81
81
  - User permissions and subscription tier
82
82
  - Backend capabilities (Kuzu, Neo4j, etc.)
83
83
 
84
+ **Subgraph Support:**
85
+ This endpoint accepts both parent graph IDs and subgraph IDs.
86
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
87
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
88
+ The returned tool list is identical for parent graphs and subgraphs, as all
89
+ MCP tools work uniformly across graph boundaries.
90
+
84
91
  **Note:**
85
92
  MCP tool listing is included - no credit consumption required.
86
93
 
@@ -125,6 +132,13 @@ def sync(
125
132
  - User permissions and subscription tier
126
133
  - Backend capabilities (Kuzu, Neo4j, etc.)
127
134
 
135
+ **Subgraph Support:**
136
+ This endpoint accepts both parent graph IDs and subgraph IDs.
137
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
138
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
139
+ The returned tool list is identical for parent graphs and subgraphs, as all
140
+ MCP tools work uniformly across graph boundaries.
141
+
128
142
  **Note:**
129
143
  MCP tool listing is included - no credit consumption required.
130
144
 
@@ -164,6 +178,13 @@ async def asyncio_detailed(
164
178
  - User permissions and subscription tier
165
179
  - Backend capabilities (Kuzu, Neo4j, etc.)
166
180
 
181
+ **Subgraph Support:**
182
+ This endpoint accepts both parent graph IDs and subgraph IDs.
183
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
184
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
185
+ The returned tool list is identical for parent graphs and subgraphs, as all
186
+ MCP tools work uniformly across graph boundaries.
187
+
167
188
  **Note:**
168
189
  MCP tool listing is included - no credit consumption required.
169
190
 
@@ -206,6 +227,13 @@ async def asyncio(
206
227
  - User permissions and subscription tier
207
228
  - Backend capabilities (Kuzu, Neo4j, etc.)
208
229
 
230
+ **Subgraph Support:**
231
+ This endpoint accepts both parent graph IDs and subgraph IDs.
232
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
233
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
234
+ The returned tool list is identical for parent graphs and subgraphs, as all
235
+ MCP tools work uniformly across graph boundaries.
236
+
209
237
  **Note:**
210
238
  MCP tool listing is included - no credit consumption required.
211
239
 
@@ -193,6 +193,12 @@ def sync_detailed(
193
193
  - `503 Service Unavailable`: Circuit breaker open or SSE disabled
194
194
  - Clients should implement exponential backoff
195
195
 
196
+ **Subgraph Support:**
197
+ This endpoint accepts both parent graph IDs and subgraph IDs.
198
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
199
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
200
+ Subgraphs share the same instance as their parent graph and have independent data.
201
+
196
202
  **Note:**
197
203
  Query operations are included - no credit consumption required.
198
204
  Queue position is based on subscription tier for priority.
@@ -298,6 +304,12 @@ def sync(
298
304
  - `503 Service Unavailable`: Circuit breaker open or SSE disabled
299
305
  - Clients should implement exponential backoff
300
306
 
307
+ **Subgraph Support:**
308
+ This endpoint accepts both parent graph IDs and subgraph IDs.
309
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
310
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
311
+ Subgraphs share the same instance as their parent graph and have independent data.
312
+
301
313
  **Note:**
302
314
  Query operations are included - no credit consumption required.
303
315
  Queue position is based on subscription tier for priority.
@@ -398,6 +410,12 @@ async def asyncio_detailed(
398
410
  - `503 Service Unavailable`: Circuit breaker open or SSE disabled
399
411
  - Clients should implement exponential backoff
400
412
 
413
+ **Subgraph Support:**
414
+ This endpoint accepts both parent graph IDs and subgraph IDs.
415
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
416
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
417
+ Subgraphs share the same instance as their parent graph and have independent data.
418
+
401
419
  **Note:**
402
420
  Query operations are included - no credit consumption required.
403
421
  Queue position is based on subscription tier for priority.
@@ -501,6 +519,12 @@ async def asyncio(
501
519
  - `503 Service Unavailable`: Circuit breaker open or SSE disabled
502
520
  - Clients should implement exponential backoff
503
521
 
522
+ **Subgraph Support:**
523
+ This endpoint accepts both parent graph IDs and subgraph IDs.
524
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
525
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
526
+ Subgraphs share the same instance as their parent graph and have independent data.
527
+
504
528
  **Note:**
505
529
  Query operations are included - no credit consumption required.
506
530
  Queue position is based on subscription tier for priority.
@@ -105,6 +105,14 @@ def sync_detailed(
105
105
  Property discovery is limited to 10 properties per node type for performance.
106
106
  For complete schema definitions, use `/schema/export`.
107
107
 
108
+ ## Subgraph Support
109
+
110
+ This endpoint accepts both parent graph IDs and subgraph IDs.
111
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
112
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
113
+ Each subgraph has independent schema and data. The returned schema reflects
114
+ only the specified graph/subgraph's actual structure.
115
+
108
116
  This operation is included - no credit consumption required.
109
117
 
110
118
  Args:
@@ -171,6 +179,14 @@ def sync(
171
179
  Property discovery is limited to 10 properties per node type for performance.
172
180
  For complete schema definitions, use `/schema/export`.
173
181
 
182
+ ## Subgraph Support
183
+
184
+ This endpoint accepts both parent graph IDs and subgraph IDs.
185
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
186
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
187
+ Each subgraph has independent schema and data. The returned schema reflects
188
+ only the specified graph/subgraph's actual structure.
189
+
174
190
  This operation is included - no credit consumption required.
175
191
 
176
192
  Args:
@@ -232,6 +248,14 @@ async def asyncio_detailed(
232
248
  Property discovery is limited to 10 properties per node type for performance.
233
249
  For complete schema definitions, use `/schema/export`.
234
250
 
251
+ ## Subgraph Support
252
+
253
+ This endpoint accepts both parent graph IDs and subgraph IDs.
254
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
255
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
256
+ Each subgraph has independent schema and data. The returned schema reflects
257
+ only the specified graph/subgraph's actual structure.
258
+
235
259
  This operation is included - no credit consumption required.
236
260
 
237
261
  Args:
@@ -296,6 +320,14 @@ async def asyncio(
296
320
  Property discovery is limited to 10 properties per node type for performance.
297
321
  For complete schema definitions, use `/schema/export`.
298
322
 
323
+ ## Subgraph Support
324
+
325
+ This endpoint accepts both parent graph IDs and subgraph IDs.
326
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
327
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
328
+ Each subgraph has independent schema and data. The returned schema reflects
329
+ only the specified graph/subgraph's actual structure.
330
+
299
331
  This operation is included - no credit consumption required.
300
332
 
301
333
  Args: