robosystems-client 0.2.14__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.

@@ -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:
@@ -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:
@@ -105,6 +105,13 @@ def sync_detailed(
105
105
  - Performance problems
106
106
  - Naming conflicts
107
107
 
108
+ **Subgraph Support:**
109
+ This endpoint accepts both parent graph IDs and subgraph IDs.
110
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
111
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
112
+ Schema validation is performed against the specified graph/subgraph's current
113
+ schema and data structure.
114
+
108
115
  This operation is included - no credit consumption required.
109
116
 
110
117
  Args:
@@ -160,6 +167,13 @@ def sync(
160
167
  - Performance problems
161
168
  - Naming conflicts
162
169
 
170
+ **Subgraph Support:**
171
+ This endpoint accepts both parent graph IDs and subgraph IDs.
172
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
173
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
174
+ Schema validation is performed against the specified graph/subgraph's current
175
+ schema and data structure.
176
+
163
177
  This operation is included - no credit consumption required.
164
178
 
165
179
  Args:
@@ -210,6 +224,13 @@ async def asyncio_detailed(
210
224
  - Performance problems
211
225
  - Naming conflicts
212
226
 
227
+ **Subgraph Support:**
228
+ This endpoint accepts both parent graph IDs and subgraph IDs.
229
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
230
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
231
+ Schema validation is performed against the specified graph/subgraph's current
232
+ schema and data structure.
233
+
213
234
  This operation is included - no credit consumption required.
214
235
 
215
236
  Args:
@@ -263,6 +284,13 @@ async def asyncio(
263
284
  - Performance problems
264
285
  - Naming conflicts
265
286
 
287
+ **Subgraph Support:**
288
+ This endpoint accepts both parent graph IDs and subgraph IDs.
289
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
290
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
291
+ Schema validation is performed against the specified graph/subgraph's current
292
+ schema and data structure.
293
+
266
294
  This operation is included - no credit consumption required.
267
295
 
268
296
  Args:
@@ -81,6 +81,12 @@ def sync_detailed(
81
81
 
82
82
  **Returns:**
83
83
  - Created subgraph details including its unique ID
84
+ - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
85
+
86
+ **Usage:**
87
+ - Subgraphs share parent's credit pool
88
+ - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}/*` endpoints
89
+ - Permissions inherited from parent graph
84
90
 
85
91
  Args:
86
92
  graph_id (str):
@@ -126,6 +132,12 @@ def sync(
126
132
 
127
133
  **Returns:**
128
134
  - Created subgraph details including its unique ID
135
+ - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
136
+
137
+ **Usage:**
138
+ - Subgraphs share parent's credit pool
139
+ - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}/*` endpoints
140
+ - Permissions inherited from parent graph
129
141
 
130
142
  Args:
131
143
  graph_id (str):
@@ -166,6 +178,12 @@ async def asyncio_detailed(
166
178
 
167
179
  **Returns:**
168
180
  - Created subgraph details including its unique ID
181
+ - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
182
+
183
+ **Usage:**
184
+ - Subgraphs share parent's credit pool
185
+ - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}/*` endpoints
186
+ - Permissions inherited from parent graph
169
187
 
170
188
  Args:
171
189
  graph_id (str):
@@ -209,6 +227,12 @@ async def asyncio(
209
227
 
210
228
  **Returns:**
211
229
  - Created subgraph details including its unique ID
230
+ - Subgraph ID format: `{parent_id}_{subgraph_name}` (e.g., kg1234567890abcdef_dev)
231
+
232
+ **Usage:**
233
+ - Subgraphs share parent's credit pool
234
+ - Subgraph ID can be used in all standard `/v1/graphs/{graph_id}/*` endpoints
235
+ - Permissions inherited from parent graph
212
236
 
213
237
  Args:
214
238
  graph_id (str):
@@ -13,7 +13,7 @@ from ...types import Response
13
13
 
14
14
  def _get_kwargs(
15
15
  graph_id: str,
16
- subgraph_id: str,
16
+ subgraph_name: str,
17
17
  *,
18
18
  body: DeleteSubgraphRequest,
19
19
  ) -> dict[str, Any]:
@@ -21,7 +21,7 @@ def _get_kwargs(
21
21
 
22
22
  _kwargs: dict[str, Any] = {
23
23
  "method": "delete",
24
- "url": f"/v1/graphs/{graph_id}/subgraphs/{subgraph_id}",
24
+ "url": f"/v1/graphs/{graph_id}/subgraphs/{subgraph_name}",
25
25
  }
26
26
 
27
27
  _kwargs["json"] = body.to_dict()
@@ -88,7 +88,7 @@ def _build_response(
88
88
 
89
89
  def sync_detailed(
90
90
  graph_id: str,
91
- subgraph_id: str,
91
+ subgraph_name: str,
92
92
  *,
93
93
  client: AuthenticatedClient,
94
94
  body: DeleteSubgraphRequest,
@@ -100,6 +100,7 @@ def sync_detailed(
100
100
  **Requirements:**
101
101
  - Must be a valid subgraph (not parent graph)
102
102
  - User must have admin access to parent graph
103
+ - Subgraph name must be alphanumeric (1-20 characters)
103
104
  - Optional backup before deletion
104
105
 
105
106
  **Deletion Options:**
@@ -114,9 +115,14 @@ def sync_detailed(
114
115
  If backup requested, stored in S3 Kuzu database bucket at:
115
116
  `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
116
117
 
118
+ **Notes:**
119
+ - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
120
+ - Deletion does not affect parent graph's credit pool or permissions
121
+ - Backup creation consumes credits from parent graph's allocation
122
+
117
123
  Args:
118
124
  graph_id (str):
119
- subgraph_id (str): Subgraph identifier to delete
125
+ subgraph_name (str): Subgraph name to delete (e.g., 'dev', 'staging')
120
126
  body (DeleteSubgraphRequest): Request model for deleting a subgraph.
121
127
 
122
128
  Raises:
@@ -129,7 +135,7 @@ def sync_detailed(
129
135
 
130
136
  kwargs = _get_kwargs(
131
137
  graph_id=graph_id,
132
- subgraph_id=subgraph_id,
138
+ subgraph_name=subgraph_name,
133
139
  body=body,
134
140
  )
135
141
 
@@ -142,7 +148,7 @@ def sync_detailed(
142
148
 
143
149
  def sync(
144
150
  graph_id: str,
145
- subgraph_id: str,
151
+ subgraph_name: str,
146
152
  *,
147
153
  client: AuthenticatedClient,
148
154
  body: DeleteSubgraphRequest,
@@ -154,6 +160,7 @@ def sync(
154
160
  **Requirements:**
155
161
  - Must be a valid subgraph (not parent graph)
156
162
  - User must have admin access to parent graph
163
+ - Subgraph name must be alphanumeric (1-20 characters)
157
164
  - Optional backup before deletion
158
165
 
159
166
  **Deletion Options:**
@@ -168,9 +175,14 @@ def sync(
168
175
  If backup requested, stored in S3 Kuzu database bucket at:
169
176
  `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
170
177
 
178
+ **Notes:**
179
+ - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
180
+ - Deletion does not affect parent graph's credit pool or permissions
181
+ - Backup creation consumes credits from parent graph's allocation
182
+
171
183
  Args:
172
184
  graph_id (str):
173
- subgraph_id (str): Subgraph identifier to delete
185
+ subgraph_name (str): Subgraph name to delete (e.g., 'dev', 'staging')
174
186
  body (DeleteSubgraphRequest): Request model for deleting a subgraph.
175
187
 
176
188
  Raises:
@@ -183,7 +195,7 @@ def sync(
183
195
 
184
196
  return sync_detailed(
185
197
  graph_id=graph_id,
186
- subgraph_id=subgraph_id,
198
+ subgraph_name=subgraph_name,
187
199
  client=client,
188
200
  body=body,
189
201
  ).parsed
@@ -191,7 +203,7 @@ def sync(
191
203
 
192
204
  async def asyncio_detailed(
193
205
  graph_id: str,
194
- subgraph_id: str,
206
+ subgraph_name: str,
195
207
  *,
196
208
  client: AuthenticatedClient,
197
209
  body: DeleteSubgraphRequest,
@@ -203,6 +215,7 @@ async def asyncio_detailed(
203
215
  **Requirements:**
204
216
  - Must be a valid subgraph (not parent graph)
205
217
  - User must have admin access to parent graph
218
+ - Subgraph name must be alphanumeric (1-20 characters)
206
219
  - Optional backup before deletion
207
220
 
208
221
  **Deletion Options:**
@@ -217,9 +230,14 @@ async def asyncio_detailed(
217
230
  If backup requested, stored in S3 Kuzu database bucket at:
218
231
  `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
219
232
 
233
+ **Notes:**
234
+ - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
235
+ - Deletion does not affect parent graph's credit pool or permissions
236
+ - Backup creation consumes credits from parent graph's allocation
237
+
220
238
  Args:
221
239
  graph_id (str):
222
- subgraph_id (str): Subgraph identifier to delete
240
+ subgraph_name (str): Subgraph name to delete (e.g., 'dev', 'staging')
223
241
  body (DeleteSubgraphRequest): Request model for deleting a subgraph.
224
242
 
225
243
  Raises:
@@ -232,7 +250,7 @@ async def asyncio_detailed(
232
250
 
233
251
  kwargs = _get_kwargs(
234
252
  graph_id=graph_id,
235
- subgraph_id=subgraph_id,
253
+ subgraph_name=subgraph_name,
236
254
  body=body,
237
255
  )
238
256
 
@@ -243,7 +261,7 @@ async def asyncio_detailed(
243
261
 
244
262
  async def asyncio(
245
263
  graph_id: str,
246
- subgraph_id: str,
264
+ subgraph_name: str,
247
265
  *,
248
266
  client: AuthenticatedClient,
249
267
  body: DeleteSubgraphRequest,
@@ -255,6 +273,7 @@ async def asyncio(
255
273
  **Requirements:**
256
274
  - Must be a valid subgraph (not parent graph)
257
275
  - User must have admin access to parent graph
276
+ - Subgraph name must be alphanumeric (1-20 characters)
258
277
  - Optional backup before deletion
259
278
 
260
279
  **Deletion Options:**
@@ -269,9 +288,14 @@ async def asyncio(
269
288
  If backup requested, stored in S3 Kuzu database bucket at:
270
289
  `s3://{kuzu_s3_bucket}/{instance_id}/{database_name}_{timestamp}.backup`
271
290
 
291
+ **Notes:**
292
+ - Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID
293
+ - Deletion does not affect parent graph's credit pool or permissions
294
+ - Backup creation consumes credits from parent graph's allocation
295
+
272
296
  Args:
273
297
  graph_id (str):
274
- subgraph_id (str): Subgraph identifier to delete
298
+ subgraph_name (str): Subgraph name to delete (e.g., 'dev', 'staging')
275
299
  body (DeleteSubgraphRequest): Request model for deleting a subgraph.
276
300
 
277
301
  Raises:
@@ -285,7 +309,7 @@ async def asyncio(
285
309
  return (
286
310
  await asyncio_detailed(
287
311
  graph_id=graph_id,
288
- subgraph_id=subgraph_id,
312
+ subgraph_name=subgraph_name,
289
313
  client=client,
290
314
  body=body,
291
315
  )
@@ -12,11 +12,11 @@ from ...types import Response
12
12
 
13
13
  def _get_kwargs(
14
14
  graph_id: str,
15
- subgraph_id: str,
15
+ subgraph_name: str,
16
16
  ) -> dict[str, Any]:
17
17
  _kwargs: dict[str, Any] = {
18
18
  "method": "get",
19
- "url": f"/v1/graphs/{graph_id}/subgraphs/{subgraph_id}/info",
19
+ "url": f"/v1/graphs/{graph_id}/subgraphs/{subgraph_name}/info",
20
20
  }
21
21
 
22
22
  return _kwargs
@@ -74,7 +74,7 @@ def _build_response(
74
74
 
75
75
  def sync_detailed(
76
76
  graph_id: str,
77
- subgraph_id: str,
77
+ subgraph_name: str,
78
78
  *,
79
79
  client: AuthenticatedClient,
80
80
  ) -> Response[Union[Any, HTTPValidationError, SubgraphResponse]]:
@@ -84,6 +84,7 @@ def sync_detailed(
84
84
 
85
85
  **Requirements:**
86
86
  - User must have read access to parent graph
87
+ - Subgraph name must be alphanumeric (1-20 characters)
87
88
 
88
89
  **Response includes:**
89
90
  - Full subgraph metadata
@@ -100,9 +101,13 @@ def sync_detailed(
100
101
  - Database size on disk
101
102
  - Schema information
102
103
 
104
+ **Note:**
105
+ Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
106
+ The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
107
+
103
108
  Args:
104
109
  graph_id (str):
105
- subgraph_id (str): Subgraph identifier
110
+ subgraph_name (str): Subgraph name (e.g., 'dev', 'staging')
106
111
 
107
112
  Raises:
108
113
  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(
114
119
 
115
120
  kwargs = _get_kwargs(
116
121
  graph_id=graph_id,
117
- subgraph_id=subgraph_id,
122
+ subgraph_name=subgraph_name,
118
123
  )
119
124
 
120
125
  response = client.get_httpx_client().request(
@@ -126,7 +131,7 @@ def sync_detailed(
126
131
 
127
132
  def sync(
128
133
  graph_id: str,
129
- subgraph_id: str,
134
+ subgraph_name: str,
130
135
  *,
131
136
  client: AuthenticatedClient,
132
137
  ) -> Optional[Union[Any, HTTPValidationError, SubgraphResponse]]:
@@ -136,6 +141,7 @@ def sync(
136
141
 
137
142
  **Requirements:**
138
143
  - User must have read access to parent graph
144
+ - Subgraph name must be alphanumeric (1-20 characters)
139
145
 
140
146
  **Response includes:**
141
147
  - Full subgraph metadata
@@ -152,9 +158,13 @@ def sync(
152
158
  - Database size on disk
153
159
  - Schema information
154
160
 
161
+ **Note:**
162
+ Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
163
+ The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
164
+
155
165
  Args:
156
166
  graph_id (str):
157
- subgraph_id (str): Subgraph identifier
167
+ subgraph_name (str): Subgraph name (e.g., 'dev', 'staging')
158
168
 
159
169
  Raises:
160
170
  errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -166,14 +176,14 @@ def sync(
166
176
 
167
177
  return sync_detailed(
168
178
  graph_id=graph_id,
169
- subgraph_id=subgraph_id,
179
+ subgraph_name=subgraph_name,
170
180
  client=client,
171
181
  ).parsed
172
182
 
173
183
 
174
184
  async def asyncio_detailed(
175
185
  graph_id: str,
176
- subgraph_id: str,
186
+ subgraph_name: str,
177
187
  *,
178
188
  client: AuthenticatedClient,
179
189
  ) -> Response[Union[Any, HTTPValidationError, SubgraphResponse]]:
@@ -183,6 +193,7 @@ async def asyncio_detailed(
183
193
 
184
194
  **Requirements:**
185
195
  - User must have read access to parent graph
196
+ - Subgraph name must be alphanumeric (1-20 characters)
186
197
 
187
198
  **Response includes:**
188
199
  - Full subgraph metadata
@@ -199,9 +210,13 @@ async def asyncio_detailed(
199
210
  - Database size on disk
200
211
  - Schema information
201
212
 
213
+ **Note:**
214
+ Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
215
+ The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
216
+
202
217
  Args:
203
218
  graph_id (str):
204
- subgraph_id (str): Subgraph identifier
219
+ subgraph_name (str): Subgraph name (e.g., 'dev', 'staging')
205
220
 
206
221
  Raises:
207
222
  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(
213
228
 
214
229
  kwargs = _get_kwargs(
215
230
  graph_id=graph_id,
216
- subgraph_id=subgraph_id,
231
+ subgraph_name=subgraph_name,
217
232
  )
218
233
 
219
234
  response = await client.get_async_httpx_client().request(**kwargs)
@@ -223,7 +238,7 @@ async def asyncio_detailed(
223
238
 
224
239
  async def asyncio(
225
240
  graph_id: str,
226
- subgraph_id: str,
241
+ subgraph_name: str,
227
242
  *,
228
243
  client: AuthenticatedClient,
229
244
  ) -> Optional[Union[Any, HTTPValidationError, SubgraphResponse]]:
@@ -233,6 +248,7 @@ async def asyncio(
233
248
 
234
249
  **Requirements:**
235
250
  - User must have read access to parent graph
251
+ - Subgraph name must be alphanumeric (1-20 characters)
236
252
 
237
253
  **Response includes:**
238
254
  - Full subgraph metadata
@@ -249,9 +265,13 @@ async def asyncio(
249
265
  - Database size on disk
250
266
  - Schema information
251
267
 
268
+ **Note:**
269
+ Use the subgraph name (e.g., 'dev', 'staging') not the full subgraph ID.
270
+ The full ID is returned in the response (e.g., 'kg0123456789abcdef_dev').
271
+
252
272
  Args:
253
273
  graph_id (str):
254
- subgraph_id (str): Subgraph identifier
274
+ subgraph_name (str): Subgraph name (e.g., 'dev', 'staging')
255
275
 
256
276
  Raises:
257
277
  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(
264
284
  return (
265
285
  await asyncio_detailed(
266
286
  graph_id=graph_id,
267
- subgraph_id=subgraph_id,
287
+ subgraph_name=subgraph_name,
268
288
  client=client,
269
289
  )
270
290
  ).parsed
@@ -123,6 +123,13 @@ def sync_detailed(
123
123
  Tables are automatically created on first file upload with type inferred from name
124
124
  (e.g., \"Transaction\" → relationship) and empty schema populated during ingestion.
125
125
 
126
+ **Subgraph Support:**
127
+ This endpoint accepts both parent graph IDs and subgraph IDs.
128
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
129
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
130
+ Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
131
+ to one subgraph do not appear in other subgraphs.
132
+
126
133
  **Important Notes:**
127
134
  - Presigned URLs expire (default: 1 hour)
128
135
  - Use appropriate Content-Type header when uploading to S3
@@ -192,6 +199,13 @@ def sync(
192
199
  Tables are automatically created on first file upload with type inferred from name
193
200
  (e.g., \"Transaction\" → relationship) and empty schema populated during ingestion.
194
201
 
202
+ **Subgraph Support:**
203
+ This endpoint accepts both parent graph IDs and subgraph IDs.
204
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
205
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
206
+ Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
207
+ to one subgraph do not appear in other subgraphs.
208
+
195
209
  **Important Notes:**
196
210
  - Presigned URLs expire (default: 1 hour)
197
211
  - Use appropriate Content-Type header when uploading to S3
@@ -256,6 +270,13 @@ async def asyncio_detailed(
256
270
  Tables are automatically created on first file upload with type inferred from name
257
271
  (e.g., \"Transaction\" → relationship) and empty schema populated during ingestion.
258
272
 
273
+ **Subgraph Support:**
274
+ This endpoint accepts both parent graph IDs and subgraph IDs.
275
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
276
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
277
+ Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
278
+ to one subgraph do not appear in other subgraphs.
279
+
259
280
  **Important Notes:**
260
281
  - Presigned URLs expire (default: 1 hour)
261
282
  - Use appropriate Content-Type header when uploading to S3
@@ -323,6 +344,13 @@ async def asyncio(
323
344
  Tables are automatically created on first file upload with type inferred from name
324
345
  (e.g., \"Transaction\" → relationship) and empty schema populated during ingestion.
325
346
 
347
+ **Subgraph Support:**
348
+ This endpoint accepts both parent graph IDs and subgraph IDs.
349
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
350
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
351
+ Each subgraph has completely isolated S3 staging areas and tables. Files uploaded
352
+ to one subgraph do not appear in other subgraphs.
353
+
326
354
  **Important Notes:**
327
355
  - Presigned URLs expire (default: 1 hour)
328
356
  - Use appropriate Content-Type header when uploading to S3
@@ -110,7 +110,7 @@ def sync_detailed(
110
110
  2. Files are validated and marked as 'uploaded'
111
111
  3. Trigger ingestion: `POST /tables/ingest`
112
112
  4. DuckDB staging tables created from S3 patterns
113
- 5. Data copied row-by-row from DuckDB to Kuzu
113
+ 5. Data copied from DuckDB to Kuzu
114
114
  6. Per-table results and metrics returned
115
115
 
116
116
  **Rebuild Feature:**
@@ -141,6 +141,13 @@ def sync_detailed(
141
141
  you'll receive a 409 Conflict error. The distributed lock automatically expires after
142
142
  the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
143
143
 
144
+ **Subgraph Support:**
145
+ This endpoint accepts both parent graph IDs and subgraph IDs.
146
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
147
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
148
+ Each subgraph has independent staging tables and graph data. Ingestion operates
149
+ on the specified graph/subgraph only and does not affect other subgraphs.
150
+
144
151
  **Important Notes:**
145
152
  - Only files with 'uploaded' status are processed
146
153
  - Tables with no uploaded files are skipped
@@ -198,7 +205,7 @@ def sync(
198
205
  2. Files are validated and marked as 'uploaded'
199
206
  3. Trigger ingestion: `POST /tables/ingest`
200
207
  4. DuckDB staging tables created from S3 patterns
201
- 5. Data copied row-by-row from DuckDB to Kuzu
208
+ 5. Data copied from DuckDB to Kuzu
202
209
  6. Per-table results and metrics returned
203
210
 
204
211
  **Rebuild Feature:**
@@ -229,6 +236,13 @@ def sync(
229
236
  you'll receive a 409 Conflict error. The distributed lock automatically expires after
230
237
  the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
231
238
 
239
+ **Subgraph Support:**
240
+ This endpoint accepts both parent graph IDs and subgraph IDs.
241
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
242
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
243
+ Each subgraph has independent staging tables and graph data. Ingestion operates
244
+ on the specified graph/subgraph only and does not affect other subgraphs.
245
+
232
246
  **Important Notes:**
233
247
  - Only files with 'uploaded' status are processed
234
248
  - Tables with no uploaded files are skipped
@@ -281,7 +295,7 @@ async def asyncio_detailed(
281
295
  2. Files are validated and marked as 'uploaded'
282
296
  3. Trigger ingestion: `POST /tables/ingest`
283
297
  4. DuckDB staging tables created from S3 patterns
284
- 5. Data copied row-by-row from DuckDB to Kuzu
298
+ 5. Data copied from DuckDB to Kuzu
285
299
  6. Per-table results and metrics returned
286
300
 
287
301
  **Rebuild Feature:**
@@ -312,6 +326,13 @@ async def asyncio_detailed(
312
326
  you'll receive a 409 Conflict error. The distributed lock automatically expires after
313
327
  the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
314
328
 
329
+ **Subgraph Support:**
330
+ This endpoint accepts both parent graph IDs and subgraph IDs.
331
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
332
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
333
+ Each subgraph has independent staging tables and graph data. Ingestion operates
334
+ on the specified graph/subgraph only and does not affect other subgraphs.
335
+
315
336
  **Important Notes:**
316
337
  - Only files with 'uploaded' status are processed
317
338
  - Tables with no uploaded files are skipped
@@ -367,7 +388,7 @@ async def asyncio(
367
388
  2. Files are validated and marked as 'uploaded'
368
389
  3. Trigger ingestion: `POST /tables/ingest`
369
390
  4. DuckDB staging tables created from S3 patterns
370
- 5. Data copied row-by-row from DuckDB to Kuzu
391
+ 5. Data copied from DuckDB to Kuzu
371
392
  6. Per-table results and metrics returned
372
393
 
373
394
  **Rebuild Feature:**
@@ -398,6 +419,13 @@ async def asyncio(
398
419
  you'll receive a 409 Conflict error. The distributed lock automatically expires after
399
420
  the configured TTL (default: 1 hour) to prevent deadlocks from failed ingestions.
400
421
 
422
+ **Subgraph Support:**
423
+ This endpoint accepts both parent graph IDs and subgraph IDs.
424
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
425
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
426
+ Each subgraph has independent staging tables and graph data. Ingestion operates
427
+ on the specified graph/subgraph only and does not affect other subgraphs.
428
+
401
429
  **Important Notes:**
402
430
  - Only files with 'uploaded' status are processed
403
431
  - Tables with no uploaded files are skipped
@@ -146,6 +146,12 @@ def sync_detailed(
146
146
  - Read-only: No INSERT, UPDATE, DELETE
147
147
  - User's tables only: Cannot query other users' data
148
148
 
149
+ **Subgraph Support:**
150
+ This endpoint accepts both parent graph IDs and subgraph IDs.
151
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
152
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
153
+ Each subgraph has its own independent staging tables.
154
+
149
155
  **Shared Repositories:**
150
156
  Shared repositories (SEC, etc.) do not allow direct SQL queries.
151
157
  Use the graph query endpoint instead: `POST /v1/graphs/{graph_id}/query`
@@ -234,6 +240,12 @@ def sync(
234
240
  - Read-only: No INSERT, UPDATE, DELETE
235
241
  - User's tables only: Cannot query other users' data
236
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
+ Each subgraph has its own independent staging tables.
248
+
237
249
  **Shared Repositories:**
238
250
  Shared repositories (SEC, etc.) do not allow direct SQL queries.
239
251
  Use the graph query endpoint instead: `POST /v1/graphs/{graph_id}/query`
@@ -317,6 +329,12 @@ async def asyncio_detailed(
317
329
  - Read-only: No INSERT, UPDATE, DELETE
318
330
  - User's tables only: Cannot query other users' data
319
331
 
332
+ **Subgraph Support:**
333
+ This endpoint accepts both parent graph IDs and subgraph IDs.
334
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
335
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
336
+ Each subgraph has its own independent staging tables.
337
+
320
338
  **Shared Repositories:**
321
339
  Shared repositories (SEC, etc.) do not allow direct SQL queries.
322
340
  Use the graph query endpoint instead: `POST /v1/graphs/{graph_id}/query`
@@ -403,6 +421,12 @@ async def asyncio(
403
421
  - Read-only: No INSERT, UPDATE, DELETE
404
422
  - User's tables only: Cannot query other users' data
405
423
 
424
+ **Subgraph Support:**
425
+ This endpoint accepts both parent graph IDs and subgraph IDs.
426
+ - Parent graph: Use `graph_id` like `kg0123456789abcdef`
427
+ - Subgraph: Use full subgraph ID like `kg0123456789abcdef_dev`
428
+ Each subgraph has its own independent staging tables.
429
+
406
430
  **Shared Repositories:**
407
431
  Shared repositories (SEC, etc.) do not allow direct SQL queries.
408
432
  Use the graph query endpoint instead: `POST /v1/graphs/{graph_id}/query`
@@ -18,9 +18,9 @@ class PaymentMethod:
18
18
  type_ (str): Payment method type (card, bank_account, etc.)
19
19
  is_default (bool): Whether this is the default payment method
20
20
  brand (Union[None, Unset, str]): Card brand (visa, mastercard, etc.)
21
- last4 (Union[None, Unset, str]): Last 4 digits
22
- exp_month (Union[None, Unset, int]): Expiration month
23
- exp_year (Union[None, Unset, int]): Expiration year
21
+ last4 (Union[None, Unset, str]): Last 4 digits of the card or account number
22
+ exp_month (Union[None, Unset, int]): Expiration month of the card
23
+ exp_year (Union[None, Unset, int]): Expiration year of the card
24
24
  """
25
25
 
26
26
  id: str
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: robosystems-client
3
- Version: 0.2.14
3
+ Version: 0.2.15
4
4
  Summary: Python Client for RoboSystems financial graph database API
5
5
  Author: RFS LLC
6
6
  License: MIT
@@ -6,7 +6,7 @@ robosystems_client/sdk-config.yaml,sha256=Y_A8qSC2zHLYy6d443Rlgdkw2GleOSFjYvq_Qm
6
6
  robosystems_client/types.py,sha256=l5mTsR9GphXnb6qHvveUHNZ_GpiRMqweGNjgKmn6qXE,1349
7
7
  robosystems_client/api/__init__.py,sha256=zTSiG_ujSjAqWPyc435YXaX9XTlpMjiJWBbV-f-YtdA,45
8
8
  robosystems_client/api/agent/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
9
- robosystems_client/api/agent/auto_select_agent.py,sha256=6jiddkXrfm-JCc3E6CW0qVsSur0dfKkVeVlYttzfCqo,15096
9
+ robosystems_client/api/agent/auto_select_agent.py,sha256=5dSWO6S-sNsXItiAGzQFWOklLTN99kApZRYhwF8LSRo,16576
10
10
  robosystems_client/api/agent/batch_process_queries.py,sha256=t_CSO2XTbKAFOWR-Ac8ALxu6ZmCL7ZnYOeDvTonwu2k,6785
11
11
  robosystems_client/api/agent/execute_specific_agent.py,sha256=IqP08Vq-mpT_66i6XqRumVlGVfw4FzZzFJxdfyQkTSc,9608
12
12
  robosystems_client/api/agent/get_agent_metadata.py,sha256=CsAMH3vzVXo7KJ95zlf1oT5juLmjIWahsEmFkpG_9Kk,5818
@@ -63,11 +63,11 @@ robosystems_client/api/credits_/get_credit_summary.py,sha256=-uvETiHAuFBDtzeIAc8
63
63
  robosystems_client/api/credits_/get_storage_usage.py,sha256=oFlj7Ziiopk9vXRWAtHHDCy_vtvufCNoOrtD9mkFMR0,6770
64
64
  robosystems_client/api/credits_/list_credit_transactions.py,sha256=9Ny3tqu2nFTEa7jB8XHABxJjLL8dLPZu4ILRHcjMv9M,12322
65
65
  robosystems_client/api/graph_health/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
66
- robosystems_client/api/graph_health/get_database_health.py,sha256=aEUYDiUMQ-paxRrABb9xY3dgs_mW7loyTuz5Y4oX790,7318
66
+ robosystems_client/api/graph_health/get_database_health.py,sha256=7ev2oIEDvqMbJkk8eK5-bW7hWNOHtJMdrpZqJXRn6xE,8826
67
67
  robosystems_client/api/graph_info/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
68
- robosystems_client/api/graph_info/get_database_info.py,sha256=u1pUs1PCxFS6g9NSg07K-B6qSo9Csx7Df9WNyV-rLdI,7654
68
+ robosystems_client/api/graph_info/get_database_info.py,sha256=G9Cgjq5XyKResc8WQYX2w-UG0yBhQeDHqcLySyNrjgE,9086
69
69
  robosystems_client/api/graph_limits/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
70
- robosystems_client/api/graph_limits/get_graph_limits.py,sha256=LbSLwPGojoK5jZ0ZZdG2GNp7ow8mPRfUO0Pzi0vFtjw,6983
70
+ robosystems_client/api/graph_limits/get_graph_limits.py,sha256=K2pxSuVAESa6y6gw7HwL70VcgLkqKOZ-FcyuKI4W4Ac,7019
71
71
  robosystems_client/api/graphs/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
72
72
  robosystems_client/api/graphs/create_graph.py,sha256=LpklD_BG9EaBuuDmHif1RAK_86jVM1y57o0bP9_5nHA,16748
73
73
  robosystems_client/api/graphs/get_available_extensions.py,sha256=A4gVvWGgSP1aCsyRqSxZp9n1c8Qq0fxuVHpFVhA6EsQ,8385
@@ -75,8 +75,8 @@ robosystems_client/api/graphs/get_available_graph_tiers.py,sha256=t9ikSV2pzp4tXM
75
75
  robosystems_client/api/graphs/get_graphs.py,sha256=GS9rsZMtUBDwFQsu31bBHDOqz5vIqtem_0KOIRE3YPg,10989
76
76
  robosystems_client/api/graphs/select_graph.py,sha256=OMl8lnKhKdFLK1iREbVSzNkaL7eQNmy88XrN4RiRELQ,9398
77
77
  robosystems_client/api/mcp/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
78
- robosystems_client/api/mcp/call_mcp_tool.py,sha256=oG2S_iwneUhe6A14xk0yVFs9x5v8IoubIA5ABsEKV7U,13662
79
- robosystems_client/api/mcp/list_mcp_tools.py,sha256=aB5ezh-ENrXxdSaGi8ZJB_012qv0sb7JL-1L4za3Q0k,6542
78
+ robosystems_client/api/mcp/call_mcp_tool.py,sha256=qNyqdJ8FQJOMkRstOzrVSMZ0hx31xHytAey3MQs5MQs,15106
79
+ robosystems_client/api/mcp/list_mcp_tools.py,sha256=jfuhgmhlXmrHy78Ovm3CMX-VyfP-85lTbJjFsW1esvM,7914
80
80
  robosystems_client/api/operations/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
81
81
  robosystems_client/api/operations/cancel_operation.py,sha256=Vq0-RzmtCOuUtYYkIrMv4TamIeGAM5bp8JOaE7YGwlE,6140
82
82
  robosystems_client/api/operations/get_operation_status.py,sha256=tawSEB1rC1csGB2tbwvGucCCZslw6sedskXeOZ0H5d0,6913
@@ -96,19 +96,19 @@ robosystems_client/api/org_usage/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12L
96
96
  robosystems_client/api/org_usage/get_org_limits.py,sha256=t8m5-8xbCUqaHEE5SWL4iaXnU2jze00SwBTR-eCLLv8,4081
97
97
  robosystems_client/api/org_usage/get_org_usage.py,sha256=tqHdLWZVx3uqVO-brbFm6WLRudNV77Z_j_rZJiSAoCk,4748
98
98
  robosystems_client/api/query/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
99
- robosystems_client/api/query/execute_cypher_query.py,sha256=QRmCTp6PXW41G8gA4Nqu0MCeYJ6zjnRUd2v9tgD76qs,19364
99
+ robosystems_client/api/query/execute_cypher_query.py,sha256=Uv1HX9I-SaVSzAvmwX41vgc8q4sS7O1oOxyAg8hmu7c,20556
100
100
  robosystems_client/api/schema/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
101
101
  robosystems_client/api/schema/export_graph_schema.py,sha256=4h01619pPXVRZlfI2rs5QD9Ne7AjmrENjjgp8Fa_d1g,12697
102
- robosystems_client/api/schema/get_graph_schema.py,sha256=EedSj2Ao2-5kqspViJLKz6tpb6lS3A--5lpFc-311YM,10214
103
- robosystems_client/api/schema/validate_schema.py,sha256=MMMphsRcRPTHp2wfLP8ujsaO_Xe3muYTNdflmJa7EYM,8320
102
+ robosystems_client/api/schema/get_graph_schema.py,sha256=JvR_TF2oL9rCxoc4mNRVJ8EqL27DUCwLKe1wv_oAnO0,11598
103
+ robosystems_client/api/schema/validate_schema.py,sha256=zcd5crOfXQcz-OLR6Mzg02hXzT9FED5y112fP2kHlaI,9608
104
104
  robosystems_client/api/service_offerings/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
105
105
  robosystems_client/api/service_offerings/get_service_offerings.py,sha256=dxoReNzU1gBRTIAi7MYq2nLrFHN_ygtTNUdKdHBviN8,7868
106
106
  robosystems_client/api/status/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
107
107
  robosystems_client/api/status/get_service_status.py,sha256=eRAk7piCdm3R9A0MfmMardMEhFmzjydFo9SDLjAbQKA,3306
108
108
  robosystems_client/api/subgraphs/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
109
- robosystems_client/api/subgraphs/create_subgraph.py,sha256=o6TuSM4qlT30YkT2ucsA986Rmr0PeyGoJa5C4FxbuxA,6458
110
- robosystems_client/api/subgraphs/delete_subgraph.py,sha256=eeISU_8o-xll04cA0ZX51gv6JxmvvBFId9D6gm8LVbg,8007
111
- robosystems_client/api/subgraphs/get_subgraph_info.py,sha256=fW8mLkHKhsEIUIIT-ErITGs-9hy51h9S6gjoutrfBx0,6711
109
+ robosystems_client/api/subgraphs/create_subgraph.py,sha256=B1GcOorDTQwb3HalqOXYeu-Uj-4WAps4YfmUSNLUGzs,7514
110
+ robosystems_client/api/subgraphs/delete_subgraph.py,sha256=WKvRhnZQfMctztZZGyP085VGtBJ2Z5CXPefqmv6PpFQ,9263
111
+ robosystems_client/api/subgraphs/get_subgraph_info.py,sha256=qfTx80KfZiTcS_PnA7AGh7C9jrivEe3d6v8jPyfyC-c,7707
112
112
  robosystems_client/api/subgraphs/get_subgraph_quota.py,sha256=Wk1BTXoe6HhRFgB75gtnnMecFSNqT7J_CVo1-QnJMRs,6512
113
113
  robosystems_client/api/subgraphs/list_subgraphs.py,sha256=d9exlLZsr9_jqhwaGUMK8mKPSbiHGLCjTNQy7uc7HkE,5350
114
114
  robosystems_client/api/subscriptions/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
@@ -118,11 +118,11 @@ robosystems_client/api/subscriptions/upgrade_subscription.py,sha256=b8415k-Gv59a
118
118
  robosystems_client/api/tables/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
119
119
  robosystems_client/api/tables/delete_file.py,sha256=wYdL3mwebNcZnFfQPIIvpR_Lqj8Qj2ToeqPQiZs8wZo,9438
120
120
  robosystems_client/api/tables/get_file_info.py,sha256=v1tqq_bE6SgEpH6FijffrOrB6Tb-UlXHcohUlx-Qx3w,6675
121
- robosystems_client/api/tables/get_upload_url.py,sha256=ySHPi2DtlU2Nq7Ee1jg2ceWnjrXwIaNWOv6RoaD9FRI,10719
122
- robosystems_client/api/tables/ingest_tables.py,sha256=7_wm6cPQVyF7LJu04IRIOxBaSfKVTr4oPOTkoxLcj1g,14452
121
+ robosystems_client/api/tables/get_upload_url.py,sha256=DnxbLn_-Nv-CqXIakd5cwqBUTBV60GcuYxa08DzR0cQ,12115
122
+ robosystems_client/api/tables/ingest_tables.py,sha256=w4UD_b1Z7bGPVWscfCkzI1fKrwP8PXA5kfEWCK2MpKk,15892
123
123
  robosystems_client/api/tables/list_table_files.py,sha256=f-cS57XzOAA7jn73JllIGZjrrbjNr0r5eCOFfA86O-8,9994
124
124
  robosystems_client/api/tables/list_tables.py,sha256=U02yJ95-bGESXv5VI2WntMseaEfEkMVabVVGCE-8qDQ,9128
125
- robosystems_client/api/tables/query_tables.py,sha256=DHva2m319Z54RziiVRiPb54eZHi1P_Nscli3qN4B3Z0,14471
125
+ robosystems_client/api/tables/query_tables.py,sha256=a1-BRxN20iIxd1qDIif6mZ4F26QsYLGYyqJiOSWtwx0,15547
126
126
  robosystems_client/api/tables/update_file_status.py,sha256=d5ZiueuguE5nK8vQw-q16CAyoZoBy8zu3zMpobdoO-o,11298
127
127
  robosystems_client/api/usage/__init__.py,sha256=5vd9uJWAjRqa9xzxzYkLD1yoZ12Ld_bAaNB5WX4fbE8,56
128
128
  robosystems_client/api/usage/get_graph_metrics.py,sha256=26W8ynBfLEyNbI_OXhEkJ5NbFnPMmDBtlza7d6mbbeU,7050
@@ -320,7 +320,7 @@ robosystems_client/models/password_check_response.py,sha256=QkGKrAFrU2zpGUDxo1ki
320
320
  robosystems_client/models/password_check_response_character_types.py,sha256=fM4WuPV_L8vHGOTEFx7oV8_1w49GIBOKrupFMuSooYY,1284
321
321
  robosystems_client/models/password_policy_response.py,sha256=q-DI_QW6Jaui9VAvp1aCnhqUV9vZlp0jaOnTeGyO17o,1768
322
322
  robosystems_client/models/password_policy_response_policy.py,sha256=_v_cVOIsaHSDNt5wzP2xMPT3AueojHBkP4qK-c1AuCU,1256
323
- robosystems_client/models/payment_method.py,sha256=qRtz3BizzGgrsHzi_AbJZtBhAgI3DByv3EXQGAamxkc,4177
323
+ robosystems_client/models/payment_method.py,sha256=lUu5Co0t6TevWuR8g2kKqeT1vDGn6KZ6gQWnJ3e3xEM,4231
324
324
  robosystems_client/models/performance_insights.py,sha256=4o2Z5O8QfrX8Rj-_jAOy70UrJO58EP3XwUp-0WQA5ZM,3642
325
325
  robosystems_client/models/performance_insights_operation_stats.py,sha256=jOazO4odLlpOf0uPzwszAz1-SHrWO4AZK4g0N2q4Hlw,1280
326
326
  robosystems_client/models/performance_insights_slow_queries_item.py,sha256=b6KqRqrbOMd9s2X7WHjpMDrFCsPMHVkWHEwX7XOIdgc,1254
@@ -390,7 +390,7 @@ robosystems_client/models/upgrade_subscription_request.py,sha256=Ph-Wu1pA6zOEi6j
390
390
  robosystems_client/models/user_graphs_response.py,sha256=k4zDipn-9HqwiJHUq8Si1XSemCDJv_t9SfTtJxc6w_k,2648
391
391
  robosystems_client/models/user_response.py,sha256=uMYsvPKLo5YUwsT-PV8Tu5qrFG81X8-ODBllFyX2C6E,3650
392
392
  robosystems_client/models/validation_error.py,sha256=R77OuQG2nJ3WDFfY--xbEhg6x1D7gAAp_1UdnG8Ka2A,1949
393
- robosystems_client-0.2.14.dist-info/METADATA,sha256=FsGJES_7A21CleuLcaGwsfpwf4qa-8oUkhivRrqYVQc,3904
394
- robosystems_client-0.2.14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
395
- robosystems_client-0.2.14.dist-info/licenses/LICENSE,sha256=LjFqQPU4eQh7jAQ04SmE9eC0j74HCdXvzbo0hjW4mWo,1063
396
- robosystems_client-0.2.14.dist-info/RECORD,,
393
+ robosystems_client-0.2.15.dist-info/METADATA,sha256=wvjXVxYz961-lELQAm3V-gV7SfzrDznwMbDirbtru_c,3904
394
+ robosystems_client-0.2.15.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
395
+ robosystems_client-0.2.15.dist-info/licenses/LICENSE,sha256=LjFqQPU4eQh7jAQ04SmE9eC0j74HCdXvzbo0hjW4mWo,1063
396
+ robosystems_client-0.2.15.dist-info/RECORD,,