robosystems-client 0.2.3__py3-none-any.whl → 0.2.4__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 (103) hide show
  1. robosystems_client/api/agent/auto_select_agent.py +1 -41
  2. robosystems_client/api/agent/batch_process_queries.py +1 -41
  3. robosystems_client/api/agent/execute_specific_agent.py +1 -41
  4. robosystems_client/api/agent/get_agent_metadata.py +5 -49
  5. robosystems_client/api/agent/list_agents.py +4 -42
  6. robosystems_client/api/agent/recommend_agent.py +5 -45
  7. robosystems_client/api/auth/generate_sso_token.py +0 -18
  8. robosystems_client/api/auth/get_current_auth_user.py +14 -74
  9. robosystems_client/api/auth/logout_user.py +14 -50
  10. robosystems_client/api/auth/refresh_auth_session.py +14 -50
  11. robosystems_client/api/auth/resend_verification_email.py +14 -74
  12. robosystems_client/api/backup/create_backup.py +5 -45
  13. robosystems_client/api/backup/get_backup_download_url.py +4 -42
  14. robosystems_client/api/backup/get_backup_stats.py +5 -49
  15. robosystems_client/api/backup/list_backups.py +4 -42
  16. robosystems_client/api/backup/restore_backup.py +5 -45
  17. robosystems_client/api/connections/create_connection.py +5 -45
  18. robosystems_client/api/connections/create_link_token.py +5 -45
  19. robosystems_client/api/connections/delete_connection.py +5 -49
  20. robosystems_client/api/connections/exchange_link_token.py +5 -45
  21. robosystems_client/api/connections/get_connection.py +5 -49
  22. robosystems_client/api/connections/get_connection_options.py +5 -49
  23. robosystems_client/api/connections/init_o_auth.py +5 -45
  24. robosystems_client/api/connections/list_connections.py +4 -42
  25. robosystems_client/api/connections/oauth_callback.py +5 -45
  26. robosystems_client/api/connections/sync_connection.py +5 -45
  27. robosystems_client/api/graph_analytics/get_graph_metrics.py +5 -49
  28. robosystems_client/api/graph_analytics/get_graph_usage_stats.py +4 -42
  29. robosystems_client/api/graph_billing/get_current_graph_bill.py +5 -49
  30. robosystems_client/api/graph_billing/get_graph_billing_history.py +4 -42
  31. robosystems_client/api/graph_billing/get_graph_monthly_bill.py +5 -49
  32. robosystems_client/api/graph_billing/get_graph_usage_details.py +4 -42
  33. robosystems_client/api/graph_credits/check_credit_balance.py +0 -38
  34. robosystems_client/api/graph_credits/check_storage_limits.py +1 -45
  35. robosystems_client/api/graph_credits/get_credit_summary.py +1 -45
  36. robosystems_client/api/graph_credits/get_storage_usage.py +0 -38
  37. robosystems_client/api/graph_credits/list_credit_transactions.py +4 -42
  38. robosystems_client/api/graph_health/get_database_health.py +5 -49
  39. robosystems_client/api/graph_info/get_database_info.py +5 -49
  40. robosystems_client/api/graph_limits/get_graph_limits.py +5 -49
  41. robosystems_client/api/graphs/create_graph.py +21 -57
  42. robosystems_client/api/graphs/get_available_extensions.py +131 -15
  43. robosystems_client/api/graphs/get_graphs.py +154 -79
  44. robosystems_client/api/graphs/select_graph.py +117 -49
  45. robosystems_client/api/mcp/call_mcp_tool.py +24 -47
  46. robosystems_client/api/mcp/list_mcp_tools.py +13 -61
  47. robosystems_client/api/operations/cancel_operation.py +1 -45
  48. robosystems_client/api/operations/get_operation_status.py +1 -45
  49. robosystems_client/api/query/execute_cypher_query.py +69 -53
  50. robosystems_client/api/schema/export_graph_schema.py +223 -65
  51. robosystems_client/api/schema/get_graph_schema.py +137 -79
  52. robosystems_client/api/schema/validate_schema.py +5 -45
  53. robosystems_client/api/subgraphs/create_subgraph.py +5 -45
  54. robosystems_client/api/subgraphs/delete_subgraph.py +5 -45
  55. robosystems_client/api/subgraphs/get_subgraph_info.py +5 -49
  56. robosystems_client/api/subgraphs/get_subgraph_quota.py +5 -49
  57. robosystems_client/api/subgraphs/list_subgraphs.py +5 -49
  58. robosystems_client/api/tables/delete_file.py +181 -301
  59. robosystems_client/api/tables/get_file_info.py +117 -265
  60. robosystems_client/api/tables/get_upload_url.py +193 -389
  61. robosystems_client/api/tables/ingest_tables.py +277 -465
  62. robosystems_client/api/tables/list_table_files.py +193 -373
  63. robosystems_client/api/tables/list_tables.py +189 -361
  64. robosystems_client/api/tables/query_tables.py +85 -141
  65. robosystems_client/api/tables/update_file_status.py +205 -349
  66. robosystems_client/api/user/create_user_api_key.py +1 -41
  67. robosystems_client/api/user/get_all_credit_summaries.py +14 -111
  68. robosystems_client/api/user/get_current_user.py +14 -75
  69. robosystems_client/api/user/list_user_api_keys.py +14 -75
  70. robosystems_client/api/user/revoke_user_api_key.py +1 -45
  71. robosystems_client/api/user/update_user.py +1 -41
  72. robosystems_client/api/user/update_user_api_key.py +1 -41
  73. robosystems_client/api/user/update_user_password.py +1 -41
  74. robosystems_client/api/user_analytics/get_detailed_user_analytics.py +0 -38
  75. robosystems_client/api/user_analytics/get_user_usage_overview.py +14 -75
  76. robosystems_client/api/user_limits/get_all_shared_repository_limits.py +14 -105
  77. robosystems_client/api/user_limits/get_shared_repository_limits.py +1 -45
  78. robosystems_client/api/user_limits/get_user_limits.py +14 -75
  79. robosystems_client/api/user_limits/get_user_usage.py +14 -75
  80. robosystems_client/api/user_subscriptions/cancel_shared_repository_subscription.py +1 -45
  81. robosystems_client/api/user_subscriptions/get_repository_credits.py +1 -45
  82. robosystems_client/api/user_subscriptions/get_shared_repository_credits.py +14 -75
  83. robosystems_client/api/user_subscriptions/get_user_shared_subscriptions.py +0 -38
  84. robosystems_client/api/user_subscriptions/subscribe_to_shared_repository.py +1 -41
  85. robosystems_client/api/user_subscriptions/upgrade_shared_repository_subscription.py +1 -41
  86. robosystems_client/extensions/__init__.py +8 -1
  87. robosystems_client/extensions/auth_integration.py +1 -2
  88. robosystems_client/extensions/query_client.py +3 -2
  89. robosystems_client/extensions/sse_client.py +1 -1
  90. robosystems_client/extensions/table_ingest_client.py +5 -0
  91. robosystems_client/extensions/utils.py +2 -2
  92. robosystems_client/models/__init__.py +4 -4
  93. robosystems_client/models/create_graph_request.py +4 -3
  94. robosystems_client/models/cypher_query_request.py +5 -22
  95. robosystems_client/models/schema_export_response.py +4 -2
  96. robosystems_client/models/schema_info_response.py +77 -0
  97. robosystems_client/models/{get_graph_schema_response_getgraphschema.py → schema_info_response_schema.py} +6 -6
  98. robosystems_client/models/schema_validation_response.py +7 -6
  99. robosystems_client/models/table_query_request.py +37 -2
  100. {robosystems_client-0.2.3.dist-info → robosystems_client-0.2.4.dist-info}/METADATA +2 -4
  101. {robosystems_client-0.2.3.dist-info → robosystems_client-0.2.4.dist-info}/RECORD +103 -102
  102. {robosystems_client-0.2.3.dist-info → robosystems_client-0.2.4.dist-info}/WHEEL +0 -0
  103. {robosystems_client-0.2.3.dist-info → robosystems_client-0.2.4.dist-info}/licenses/LICENSE +0 -0
@@ -8,38 +8,18 @@ from ...client import AuthenticatedClient, Client
8
8
  from ...models.error_response import ErrorResponse
9
9
  from ...models.http_validation_error import HTTPValidationError
10
10
  from ...models.list_table_files_response import ListTableFilesResponse
11
- from ...types import UNSET, Response, Unset
11
+ from ...types import Response
12
12
 
13
13
 
14
14
  def _get_kwargs(
15
15
  graph_id: str,
16
16
  table_name: str,
17
- *,
18
- token: Union[None, Unset, str] = UNSET,
19
- authorization: Union[None, Unset, str] = UNSET,
20
17
  ) -> dict[str, Any]:
21
- headers: dict[str, Any] = {}
22
- if not isinstance(authorization, Unset):
23
- headers["authorization"] = authorization
24
-
25
- params: dict[str, Any] = {}
26
-
27
- json_token: Union[None, Unset, str]
28
- if isinstance(token, Unset):
29
- json_token = UNSET
30
- else:
31
- json_token = token
32
- params["token"] = json_token
33
-
34
- params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
35
-
36
18
  _kwargs: dict[str, Any] = {
37
19
  "method": "get",
38
20
  "url": f"/v1/graphs/{graph_id}/tables/{table_name}/files",
39
- "params": params,
40
21
  }
41
22
 
42
- _kwargs["headers"] = headers
43
23
  return _kwargs
44
24
 
45
25
 
@@ -96,99 +76,59 @@ def sync_detailed(
96
76
  table_name: str,
97
77
  *,
98
78
  client: AuthenticatedClient,
99
- token: Union[None, Unset, str] = UNSET,
100
- authorization: Union[None, Unset, str] = UNSET,
101
79
  ) -> Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]:
102
- r""" List Files in Staging Table
103
-
104
- List all files uploaded to a staging table with comprehensive metadata.
105
-
106
- **Purpose:**
107
- Get a complete inventory of all files in a staging table, including upload status,
108
- file sizes, row counts, and S3 locations. Essential for monitoring upload progress
109
- and validating data before ingestion.
110
-
111
- **Use Cases:**
112
- - Monitor file upload progress
113
- - Verify files are ready for ingestion
114
- - Check file formats and sizes
115
- - Track storage usage per table
116
- - Identify failed or incomplete uploads
117
- - Pre-ingestion validation
118
-
119
- **What You Get:**
120
- - File ID and name
121
- - File format (parquet, csv, etc.)
122
- - Size in bytes
123
- - Row count (if available)
124
- - Upload status and method
125
- - Creation and upload timestamps
126
- - S3 key for reference
127
-
128
- **Upload Status Values:**
129
- - `created`: File record created, not yet uploaded
130
- - `uploading`: Upload in progress
131
- - `uploaded`: Successfully uploaded, ready for ingestion
132
- - `failed`: Upload failed
133
-
134
- **Example Response:**
135
- ```json
136
- {
137
- \"graph_id\": \"kg123\",
138
- \"table_name\": \"Entity\",
139
- \"files\": [
140
- {
141
- \"file_id\": \"f123\",
142
- \"file_name\": \"entities_batch1.parquet\",
143
- \"file_format\": \"parquet\",
144
- \"size_bytes\": 1048576,
145
- \"row_count\": 5000,
146
- \"upload_status\": \"uploaded\",
147
- \"upload_method\": \"presigned_url\",
148
- \"created_at\": \"2025-10-28T10:00:00Z\",
149
- \"uploaded_at\": \"2025-10-28T10:01:30Z\",
150
- \"s3_key\": \"user-staging/user123/kg123/Entity/entities_batch1.parquet\"
151
- }
152
- ],
153
- \"total_files\": 1,
154
- \"total_size_bytes\": 1048576
155
- }
156
- ```
157
-
158
- **Example Usage:**
159
- ```bash
160
- curl -H \"Authorization: Bearer YOUR_TOKEN\" \
161
- https://api.robosystems.ai/v1/graphs/kg123/tables/Entity/files
162
- ```
163
-
164
- **Tips:**
165
- - Only `uploaded` files are ingested
166
- - Check `row_count` to estimate data volume
167
- - Use `total_size_bytes` for storage monitoring
168
- - Files with `failed` status should be deleted and re-uploaded
169
-
170
- **Note:**
171
- File listing is included - no credit consumption.
172
-
173
- Args:
174
- graph_id (str): Graph database identifier
175
- table_name (str): Table name
176
- token (Union[None, Unset, str]): JWT token for SSE authentication
177
- authorization (Union[None, Unset, str]):
178
-
179
- Raises:
180
- errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
181
- httpx.TimeoutException: If the request takes longer than Client.timeout.
182
-
183
- Returns:
184
- Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]
185
- """
80
+ """List Files in Staging Table
81
+
82
+ List all files uploaded to a staging table with comprehensive metadata.
83
+
84
+ Get a complete inventory of all files in a staging table, including upload status,
85
+ file sizes, row counts, and S3 locations. Essential for monitoring upload progress
86
+ and validating data before ingestion.
87
+
88
+ **Use Cases:**
89
+ - Monitor file upload progress
90
+ - Verify files are ready for ingestion
91
+ - Check file formats and sizes
92
+ - Track storage usage per table
93
+ - Identify failed or incomplete uploads
94
+ - Pre-ingestion validation
95
+
96
+ **Returned Metadata:**
97
+ - File ID, name, and format (parquet, csv, json)
98
+ - Size in bytes and row count (if available)
99
+ - Upload status and method
100
+ - Creation and upload timestamps
101
+ - S3 key for reference
102
+
103
+ **Upload Status Values:**
104
+ - `pending`: Upload URL generated, awaiting upload
105
+ - `uploaded`: Successfully uploaded, ready for ingestion
106
+ - `disabled`: Excluded from ingestion
107
+ - `archived`: Soft deleted
108
+ - `failed`: Upload failed
109
+
110
+ **Important Notes:**
111
+ - Only `uploaded` files are ingested
112
+ - Check `row_count` to estimate data volume
113
+ - Use `total_size_bytes` for storage monitoring
114
+ - Files with `failed` status should be deleted and re-uploaded
115
+ - File listing is included - no credit consumption
116
+
117
+ Args:
118
+ graph_id (str):
119
+ table_name (str): Table name
120
+
121
+ Raises:
122
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
123
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
124
+
125
+ Returns:
126
+ Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]
127
+ """
186
128
 
187
129
  kwargs = _get_kwargs(
188
130
  graph_id=graph_id,
189
131
  table_name=table_name,
190
- token=token,
191
- authorization=authorization,
192
132
  )
193
133
 
194
134
  response = client.get_httpx_client().request(
@@ -203,100 +143,60 @@ def sync(
203
143
  table_name: str,
204
144
  *,
205
145
  client: AuthenticatedClient,
206
- token: Union[None, Unset, str] = UNSET,
207
- authorization: Union[None, Unset, str] = UNSET,
208
146
  ) -> Optional[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]:
209
- r""" List Files in Staging Table
210
-
211
- List all files uploaded to a staging table with comprehensive metadata.
212
-
213
- **Purpose:**
214
- Get a complete inventory of all files in a staging table, including upload status,
215
- file sizes, row counts, and S3 locations. Essential for monitoring upload progress
216
- and validating data before ingestion.
217
-
218
- **Use Cases:**
219
- - Monitor file upload progress
220
- - Verify files are ready for ingestion
221
- - Check file formats and sizes
222
- - Track storage usage per table
223
- - Identify failed or incomplete uploads
224
- - Pre-ingestion validation
225
-
226
- **What You Get:**
227
- - File ID and name
228
- - File format (parquet, csv, etc.)
229
- - Size in bytes
230
- - Row count (if available)
231
- - Upload status and method
232
- - Creation and upload timestamps
233
- - S3 key for reference
234
-
235
- **Upload Status Values:**
236
- - `created`: File record created, not yet uploaded
237
- - `uploading`: Upload in progress
238
- - `uploaded`: Successfully uploaded, ready for ingestion
239
- - `failed`: Upload failed
240
-
241
- **Example Response:**
242
- ```json
243
- {
244
- \"graph_id\": \"kg123\",
245
- \"table_name\": \"Entity\",
246
- \"files\": [
247
- {
248
- \"file_id\": \"f123\",
249
- \"file_name\": \"entities_batch1.parquet\",
250
- \"file_format\": \"parquet\",
251
- \"size_bytes\": 1048576,
252
- \"row_count\": 5000,
253
- \"upload_status\": \"uploaded\",
254
- \"upload_method\": \"presigned_url\",
255
- \"created_at\": \"2025-10-28T10:00:00Z\",
256
- \"uploaded_at\": \"2025-10-28T10:01:30Z\",
257
- \"s3_key\": \"user-staging/user123/kg123/Entity/entities_batch1.parquet\"
258
- }
259
- ],
260
- \"total_files\": 1,
261
- \"total_size_bytes\": 1048576
262
- }
263
- ```
264
-
265
- **Example Usage:**
266
- ```bash
267
- curl -H \"Authorization: Bearer YOUR_TOKEN\" \
268
- https://api.robosystems.ai/v1/graphs/kg123/tables/Entity/files
269
- ```
270
-
271
- **Tips:**
272
- - Only `uploaded` files are ingested
273
- - Check `row_count` to estimate data volume
274
- - Use `total_size_bytes` for storage monitoring
275
- - Files with `failed` status should be deleted and re-uploaded
276
-
277
- **Note:**
278
- File listing is included - no credit consumption.
279
-
280
- Args:
281
- graph_id (str): Graph database identifier
282
- table_name (str): Table name
283
- token (Union[None, Unset, str]): JWT token for SSE authentication
284
- authorization (Union[None, Unset, str]):
285
-
286
- Raises:
287
- errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
288
- httpx.TimeoutException: If the request takes longer than Client.timeout.
289
-
290
- Returns:
291
- Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]
292
- """
147
+ """List Files in Staging Table
148
+
149
+ List all files uploaded to a staging table with comprehensive metadata.
150
+
151
+ Get a complete inventory of all files in a staging table, including upload status,
152
+ file sizes, row counts, and S3 locations. Essential for monitoring upload progress
153
+ and validating data before ingestion.
154
+
155
+ **Use Cases:**
156
+ - Monitor file upload progress
157
+ - Verify files are ready for ingestion
158
+ - Check file formats and sizes
159
+ - Track storage usage per table
160
+ - Identify failed or incomplete uploads
161
+ - Pre-ingestion validation
162
+
163
+ **Returned Metadata:**
164
+ - File ID, name, and format (parquet, csv, json)
165
+ - Size in bytes and row count (if available)
166
+ - Upload status and method
167
+ - Creation and upload timestamps
168
+ - S3 key for reference
169
+
170
+ **Upload Status Values:**
171
+ - `pending`: Upload URL generated, awaiting upload
172
+ - `uploaded`: Successfully uploaded, ready for ingestion
173
+ - `disabled`: Excluded from ingestion
174
+ - `archived`: Soft deleted
175
+ - `failed`: Upload failed
176
+
177
+ **Important Notes:**
178
+ - Only `uploaded` files are ingested
179
+ - Check `row_count` to estimate data volume
180
+ - Use `total_size_bytes` for storage monitoring
181
+ - Files with `failed` status should be deleted and re-uploaded
182
+ - File listing is included - no credit consumption
183
+
184
+ Args:
185
+ graph_id (str):
186
+ table_name (str): Table name
187
+
188
+ Raises:
189
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
190
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
191
+
192
+ Returns:
193
+ Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]
194
+ """
293
195
 
294
196
  return sync_detailed(
295
197
  graph_id=graph_id,
296
198
  table_name=table_name,
297
199
  client=client,
298
- token=token,
299
- authorization=authorization,
300
200
  ).parsed
301
201
 
302
202
 
@@ -305,99 +205,59 @@ async def asyncio_detailed(
305
205
  table_name: str,
306
206
  *,
307
207
  client: AuthenticatedClient,
308
- token: Union[None, Unset, str] = UNSET,
309
- authorization: Union[None, Unset, str] = UNSET,
310
208
  ) -> Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]:
311
- r""" List Files in Staging Table
312
-
313
- List all files uploaded to a staging table with comprehensive metadata.
314
-
315
- **Purpose:**
316
- Get a complete inventory of all files in a staging table, including upload status,
317
- file sizes, row counts, and S3 locations. Essential for monitoring upload progress
318
- and validating data before ingestion.
319
-
320
- **Use Cases:**
321
- - Monitor file upload progress
322
- - Verify files are ready for ingestion
323
- - Check file formats and sizes
324
- - Track storage usage per table
325
- - Identify failed or incomplete uploads
326
- - Pre-ingestion validation
327
-
328
- **What You Get:**
329
- - File ID and name
330
- - File format (parquet, csv, etc.)
331
- - Size in bytes
332
- - Row count (if available)
333
- - Upload status and method
334
- - Creation and upload timestamps
335
- - S3 key for reference
336
-
337
- **Upload Status Values:**
338
- - `created`: File record created, not yet uploaded
339
- - `uploading`: Upload in progress
340
- - `uploaded`: Successfully uploaded, ready for ingestion
341
- - `failed`: Upload failed
342
-
343
- **Example Response:**
344
- ```json
345
- {
346
- \"graph_id\": \"kg123\",
347
- \"table_name\": \"Entity\",
348
- \"files\": [
349
- {
350
- \"file_id\": \"f123\",
351
- \"file_name\": \"entities_batch1.parquet\",
352
- \"file_format\": \"parquet\",
353
- \"size_bytes\": 1048576,
354
- \"row_count\": 5000,
355
- \"upload_status\": \"uploaded\",
356
- \"upload_method\": \"presigned_url\",
357
- \"created_at\": \"2025-10-28T10:00:00Z\",
358
- \"uploaded_at\": \"2025-10-28T10:01:30Z\",
359
- \"s3_key\": \"user-staging/user123/kg123/Entity/entities_batch1.parquet\"
360
- }
361
- ],
362
- \"total_files\": 1,
363
- \"total_size_bytes\": 1048576
364
- }
365
- ```
366
-
367
- **Example Usage:**
368
- ```bash
369
- curl -H \"Authorization: Bearer YOUR_TOKEN\" \
370
- https://api.robosystems.ai/v1/graphs/kg123/tables/Entity/files
371
- ```
372
-
373
- **Tips:**
374
- - Only `uploaded` files are ingested
375
- - Check `row_count` to estimate data volume
376
- - Use `total_size_bytes` for storage monitoring
377
- - Files with `failed` status should be deleted and re-uploaded
378
-
379
- **Note:**
380
- File listing is included - no credit consumption.
381
-
382
- Args:
383
- graph_id (str): Graph database identifier
384
- table_name (str): Table name
385
- token (Union[None, Unset, str]): JWT token for SSE authentication
386
- authorization (Union[None, Unset, str]):
387
-
388
- Raises:
389
- errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
390
- httpx.TimeoutException: If the request takes longer than Client.timeout.
391
-
392
- Returns:
393
- Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]
394
- """
209
+ """List Files in Staging Table
210
+
211
+ List all files uploaded to a staging table with comprehensive metadata.
212
+
213
+ Get a complete inventory of all files in a staging table, including upload status,
214
+ file sizes, row counts, and S3 locations. Essential for monitoring upload progress
215
+ and validating data before ingestion.
216
+
217
+ **Use Cases:**
218
+ - Monitor file upload progress
219
+ - Verify files are ready for ingestion
220
+ - Check file formats and sizes
221
+ - Track storage usage per table
222
+ - Identify failed or incomplete uploads
223
+ - Pre-ingestion validation
224
+
225
+ **Returned Metadata:**
226
+ - File ID, name, and format (parquet, csv, json)
227
+ - Size in bytes and row count (if available)
228
+ - Upload status and method
229
+ - Creation and upload timestamps
230
+ - S3 key for reference
231
+
232
+ **Upload Status Values:**
233
+ - `pending`: Upload URL generated, awaiting upload
234
+ - `uploaded`: Successfully uploaded, ready for ingestion
235
+ - `disabled`: Excluded from ingestion
236
+ - `archived`: Soft deleted
237
+ - `failed`: Upload failed
238
+
239
+ **Important Notes:**
240
+ - Only `uploaded` files are ingested
241
+ - Check `row_count` to estimate data volume
242
+ - Use `total_size_bytes` for storage monitoring
243
+ - Files with `failed` status should be deleted and re-uploaded
244
+ - File listing is included - no credit consumption
245
+
246
+ Args:
247
+ graph_id (str):
248
+ table_name (str): Table name
249
+
250
+ Raises:
251
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
252
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
253
+
254
+ Returns:
255
+ Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]
256
+ """
395
257
 
396
258
  kwargs = _get_kwargs(
397
259
  graph_id=graph_id,
398
260
  table_name=table_name,
399
- token=token,
400
- authorization=authorization,
401
261
  )
402
262
 
403
263
  response = await client.get_async_httpx_client().request(**kwargs)
@@ -410,100 +270,60 @@ async def asyncio(
410
270
  table_name: str,
411
271
  *,
412
272
  client: AuthenticatedClient,
413
- token: Union[None, Unset, str] = UNSET,
414
- authorization: Union[None, Unset, str] = UNSET,
415
273
  ) -> Optional[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]:
416
- r""" List Files in Staging Table
417
-
418
- List all files uploaded to a staging table with comprehensive metadata.
419
-
420
- **Purpose:**
421
- Get a complete inventory of all files in a staging table, including upload status,
422
- file sizes, row counts, and S3 locations. Essential for monitoring upload progress
423
- and validating data before ingestion.
424
-
425
- **Use Cases:**
426
- - Monitor file upload progress
427
- - Verify files are ready for ingestion
428
- - Check file formats and sizes
429
- - Track storage usage per table
430
- - Identify failed or incomplete uploads
431
- - Pre-ingestion validation
432
-
433
- **What You Get:**
434
- - File ID and name
435
- - File format (parquet, csv, etc.)
436
- - Size in bytes
437
- - Row count (if available)
438
- - Upload status and method
439
- - Creation and upload timestamps
440
- - S3 key for reference
441
-
442
- **Upload Status Values:**
443
- - `created`: File record created, not yet uploaded
444
- - `uploading`: Upload in progress
445
- - `uploaded`: Successfully uploaded, ready for ingestion
446
- - `failed`: Upload failed
447
-
448
- **Example Response:**
449
- ```json
450
- {
451
- \"graph_id\": \"kg123\",
452
- \"table_name\": \"Entity\",
453
- \"files\": [
454
- {
455
- \"file_id\": \"f123\",
456
- \"file_name\": \"entities_batch1.parquet\",
457
- \"file_format\": \"parquet\",
458
- \"size_bytes\": 1048576,
459
- \"row_count\": 5000,
460
- \"upload_status\": \"uploaded\",
461
- \"upload_method\": \"presigned_url\",
462
- \"created_at\": \"2025-10-28T10:00:00Z\",
463
- \"uploaded_at\": \"2025-10-28T10:01:30Z\",
464
- \"s3_key\": \"user-staging/user123/kg123/Entity/entities_batch1.parquet\"
465
- }
466
- ],
467
- \"total_files\": 1,
468
- \"total_size_bytes\": 1048576
469
- }
470
- ```
471
-
472
- **Example Usage:**
473
- ```bash
474
- curl -H \"Authorization: Bearer YOUR_TOKEN\" \
475
- https://api.robosystems.ai/v1/graphs/kg123/tables/Entity/files
476
- ```
477
-
478
- **Tips:**
479
- - Only `uploaded` files are ingested
480
- - Check `row_count` to estimate data volume
481
- - Use `total_size_bytes` for storage monitoring
482
- - Files with `failed` status should be deleted and re-uploaded
483
-
484
- **Note:**
485
- File listing is included - no credit consumption.
486
-
487
- Args:
488
- graph_id (str): Graph database identifier
489
- table_name (str): Table name
490
- token (Union[None, Unset, str]): JWT token for SSE authentication
491
- authorization (Union[None, Unset, str]):
492
-
493
- Raises:
494
- errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
495
- httpx.TimeoutException: If the request takes longer than Client.timeout.
496
-
497
- Returns:
498
- Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]
499
- """
274
+ """List Files in Staging Table
275
+
276
+ List all files uploaded to a staging table with comprehensive metadata.
277
+
278
+ Get a complete inventory of all files in a staging table, including upload status,
279
+ file sizes, row counts, and S3 locations. Essential for monitoring upload progress
280
+ and validating data before ingestion.
281
+
282
+ **Use Cases:**
283
+ - Monitor file upload progress
284
+ - Verify files are ready for ingestion
285
+ - Check file formats and sizes
286
+ - Track storage usage per table
287
+ - Identify failed or incomplete uploads
288
+ - Pre-ingestion validation
289
+
290
+ **Returned Metadata:**
291
+ - File ID, name, and format (parquet, csv, json)
292
+ - Size in bytes and row count (if available)
293
+ - Upload status and method
294
+ - Creation and upload timestamps
295
+ - S3 key for reference
296
+
297
+ **Upload Status Values:**
298
+ - `pending`: Upload URL generated, awaiting upload
299
+ - `uploaded`: Successfully uploaded, ready for ingestion
300
+ - `disabled`: Excluded from ingestion
301
+ - `archived`: Soft deleted
302
+ - `failed`: Upload failed
303
+
304
+ **Important Notes:**
305
+ - Only `uploaded` files are ingested
306
+ - Check `row_count` to estimate data volume
307
+ - Use `total_size_bytes` for storage monitoring
308
+ - Files with `failed` status should be deleted and re-uploaded
309
+ - File listing is included - no credit consumption
310
+
311
+ Args:
312
+ graph_id (str):
313
+ table_name (str): Table name
314
+
315
+ Raises:
316
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
317
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
318
+
319
+ Returns:
320
+ Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]
321
+ """
500
322
 
501
323
  return (
502
324
  await asyncio_detailed(
503
325
  graph_id=graph_id,
504
326
  table_name=table_name,
505
327
  client=client,
506
- token=token,
507
- authorization=authorization,
508
328
  )
509
329
  ).parsed