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.delete_file_response import DeleteFileResponse
9
9
  from ...models.error_response import ErrorResponse
10
10
  from ...models.http_validation_error import HTTPValidationError
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
  file_id: 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": "delete",
38
20
  "url": f"/v1/graphs/{graph_id}/tables/files/{file_id}",
39
- "params": params,
40
21
  }
41
22
 
42
- _kwargs["headers"] = headers
43
23
  return _kwargs
44
24
 
45
25
 
@@ -96,81 +76,56 @@ def sync_detailed(
96
76
  file_id: 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, DeleteFileResponse, ErrorResponse, HTTPValidationError]]:
102
- r""" Delete File from Staging
103
-
104
- Delete a file from S3 storage and database tracking.
105
-
106
- **Purpose:**
107
- Remove unwanted, duplicate, or incorrect files from staging tables before ingestion.
108
- The file is deleted from both S3 and database tracking, and table statistics
109
- are automatically recalculated.
110
-
111
- **Use Cases:**
112
- - Remove duplicate uploads
113
- - Delete files with incorrect data
114
- - Clean up failed uploads
115
- - Fix data quality issues before ingestion
116
- - Manage storage usage
117
-
118
- **What Happens:**
119
- 1. File deleted from S3 storage
120
- 2. Database tracking record removed
121
- 3. Table statistics recalculated (file count, size, row count)
122
- 4. DuckDB automatically excludes file from future queries
123
-
124
- **Security:**
125
- - Write access required (verified via auth)
126
- - Shared repositories block file deletions
127
- - Full audit trail of deletion operations
128
- - Cannot delete after ingestion to graph
129
-
130
- **Example Response:**
131
- ```json
132
- {
133
- \"status\": \"deleted\",
134
- \"file_id\": \"f123\",
135
- \"file_name\": \"entities_batch1.parquet\",
136
- \"message\": \"File deleted successfully. DuckDB will automatically exclude it from queries.\"
137
- }
138
- ```
139
-
140
- **Example Usage:**
141
- ```bash
142
- curl -X DELETE -H \"Authorization: Bearer YOUR_TOKEN\" \
143
- https://api.robosystems.ai/v1/graphs/kg123/tables/files/f123
144
- ```
145
-
146
- **Tips:**
147
- - Delete files before ingestion for best results
148
- - Table statistics update automatically
149
- - No need to refresh DuckDB - exclusion is automatic
150
- - Consider re-uploading corrected version after deletion
151
-
152
- **Note:**
153
- File deletion is included - no credit consumption.
154
-
155
- Args:
156
- graph_id (str): Graph database identifier
157
- file_id (str): File ID
158
- token (Union[None, Unset, str]): JWT token for SSE authentication
159
- authorization (Union[None, Unset, str]):
160
-
161
- Raises:
162
- errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
163
- httpx.TimeoutException: If the request takes longer than Client.timeout.
164
-
165
- Returns:
166
- Response[Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]]
167
- """
80
+ """Delete File from Staging
81
+
82
+ Delete a file from S3 storage and database tracking.
83
+
84
+ Remove unwanted, duplicate, or incorrect files from staging tables before ingestion.
85
+ The file is deleted from both S3 and database tracking, and table statistics
86
+ are automatically recalculated.
87
+
88
+ **Use Cases:**
89
+ - Remove duplicate uploads
90
+ - Delete files with incorrect data
91
+ - Clean up failed uploads
92
+ - Fix data quality issues before ingestion
93
+ - Manage storage usage
94
+
95
+ **What Happens:**
96
+ 1. File deleted from S3 storage
97
+ 2. Database tracking record removed
98
+ 3. Table statistics recalculated (file count, size, row count)
99
+ 4. DuckDB automatically excludes file from future queries
100
+
101
+ **Security:**
102
+ - Write access required (verified via auth)
103
+ - Shared repositories block file deletions
104
+ - Full audit trail of deletion operations
105
+ - Cannot delete after ingestion to graph
106
+
107
+ **Important Notes:**
108
+ - Delete files before ingestion for best results
109
+ - Table statistics update automatically
110
+ - No need to refresh DuckDB - exclusion is automatic
111
+ - Consider re-uploading corrected version after deletion
112
+ - File deletion is included - no credit consumption
113
+
114
+ Args:
115
+ graph_id (str):
116
+ file_id (str): File ID
117
+
118
+ Raises:
119
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
120
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
121
+
122
+ Returns:
123
+ Response[Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]]
124
+ """
168
125
 
169
126
  kwargs = _get_kwargs(
170
127
  graph_id=graph_id,
171
128
  file_id=file_id,
172
- token=token,
173
- authorization=authorization,
174
129
  )
175
130
 
176
131
  response = client.get_httpx_client().request(
@@ -185,82 +140,57 @@ def sync(
185
140
  file_id: str,
186
141
  *,
187
142
  client: AuthenticatedClient,
188
- token: Union[None, Unset, str] = UNSET,
189
- authorization: Union[None, Unset, str] = UNSET,
190
143
  ) -> Optional[Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]]:
191
- r""" Delete File from Staging
192
-
193
- Delete a file from S3 storage and database tracking.
194
-
195
- **Purpose:**
196
- Remove unwanted, duplicate, or incorrect files from staging tables before ingestion.
197
- The file is deleted from both S3 and database tracking, and table statistics
198
- are automatically recalculated.
199
-
200
- **Use Cases:**
201
- - Remove duplicate uploads
202
- - Delete files with incorrect data
203
- - Clean up failed uploads
204
- - Fix data quality issues before ingestion
205
- - Manage storage usage
206
-
207
- **What Happens:**
208
- 1. File deleted from S3 storage
209
- 2. Database tracking record removed
210
- 3. Table statistics recalculated (file count, size, row count)
211
- 4. DuckDB automatically excludes file from future queries
212
-
213
- **Security:**
214
- - Write access required (verified via auth)
215
- - Shared repositories block file deletions
216
- - Full audit trail of deletion operations
217
- - Cannot delete after ingestion to graph
218
-
219
- **Example Response:**
220
- ```json
221
- {
222
- \"status\": \"deleted\",
223
- \"file_id\": \"f123\",
224
- \"file_name\": \"entities_batch1.parquet\",
225
- \"message\": \"File deleted successfully. DuckDB will automatically exclude it from queries.\"
226
- }
227
- ```
228
-
229
- **Example Usage:**
230
- ```bash
231
- curl -X DELETE -H \"Authorization: Bearer YOUR_TOKEN\" \
232
- https://api.robosystems.ai/v1/graphs/kg123/tables/files/f123
233
- ```
234
-
235
- **Tips:**
236
- - Delete files before ingestion for best results
237
- - Table statistics update automatically
238
- - No need to refresh DuckDB - exclusion is automatic
239
- - Consider re-uploading corrected version after deletion
240
-
241
- **Note:**
242
- File deletion is included - no credit consumption.
243
-
244
- Args:
245
- graph_id (str): Graph database identifier
246
- file_id (str): File ID
247
- token (Union[None, Unset, str]): JWT token for SSE authentication
248
- authorization (Union[None, Unset, str]):
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
- Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]
256
- """
144
+ """Delete File from Staging
145
+
146
+ Delete a file from S3 storage and database tracking.
147
+
148
+ Remove unwanted, duplicate, or incorrect files from staging tables before ingestion.
149
+ The file is deleted from both S3 and database tracking, and table statistics
150
+ are automatically recalculated.
151
+
152
+ **Use Cases:**
153
+ - Remove duplicate uploads
154
+ - Delete files with incorrect data
155
+ - Clean up failed uploads
156
+ - Fix data quality issues before ingestion
157
+ - Manage storage usage
158
+
159
+ **What Happens:**
160
+ 1. File deleted from S3 storage
161
+ 2. Database tracking record removed
162
+ 3. Table statistics recalculated (file count, size, row count)
163
+ 4. DuckDB automatically excludes file from future queries
164
+
165
+ **Security:**
166
+ - Write access required (verified via auth)
167
+ - Shared repositories block file deletions
168
+ - Full audit trail of deletion operations
169
+ - Cannot delete after ingestion to graph
170
+
171
+ **Important Notes:**
172
+ - Delete files before ingestion for best results
173
+ - Table statistics update automatically
174
+ - No need to refresh DuckDB - exclusion is automatic
175
+ - Consider re-uploading corrected version after deletion
176
+ - File deletion is included - no credit consumption
177
+
178
+ Args:
179
+ graph_id (str):
180
+ file_id (str): File ID
181
+
182
+ Raises:
183
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
184
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
185
+
186
+ Returns:
187
+ Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]
188
+ """
257
189
 
258
190
  return sync_detailed(
259
191
  graph_id=graph_id,
260
192
  file_id=file_id,
261
193
  client=client,
262
- token=token,
263
- authorization=authorization,
264
194
  ).parsed
265
195
 
266
196
 
@@ -269,81 +199,56 @@ async def asyncio_detailed(
269
199
  file_id: str,
270
200
  *,
271
201
  client: AuthenticatedClient,
272
- token: Union[None, Unset, str] = UNSET,
273
- authorization: Union[None, Unset, str] = UNSET,
274
202
  ) -> Response[Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]]:
275
- r""" Delete File from Staging
276
-
277
- Delete a file from S3 storage and database tracking.
278
-
279
- **Purpose:**
280
- Remove unwanted, duplicate, or incorrect files from staging tables before ingestion.
281
- The file is deleted from both S3 and database tracking, and table statistics
282
- are automatically recalculated.
283
-
284
- **Use Cases:**
285
- - Remove duplicate uploads
286
- - Delete files with incorrect data
287
- - Clean up failed uploads
288
- - Fix data quality issues before ingestion
289
- - Manage storage usage
290
-
291
- **What Happens:**
292
- 1. File deleted from S3 storage
293
- 2. Database tracking record removed
294
- 3. Table statistics recalculated (file count, size, row count)
295
- 4. DuckDB automatically excludes file from future queries
296
-
297
- **Security:**
298
- - Write access required (verified via auth)
299
- - Shared repositories block file deletions
300
- - Full audit trail of deletion operations
301
- - Cannot delete after ingestion to graph
302
-
303
- **Example Response:**
304
- ```json
305
- {
306
- \"status\": \"deleted\",
307
- \"file_id\": \"f123\",
308
- \"file_name\": \"entities_batch1.parquet\",
309
- \"message\": \"File deleted successfully. DuckDB will automatically exclude it from queries.\"
310
- }
311
- ```
312
-
313
- **Example Usage:**
314
- ```bash
315
- curl -X DELETE -H \"Authorization: Bearer YOUR_TOKEN\" \
316
- https://api.robosystems.ai/v1/graphs/kg123/tables/files/f123
317
- ```
318
-
319
- **Tips:**
320
- - Delete files before ingestion for best results
321
- - Table statistics update automatically
322
- - No need to refresh DuckDB - exclusion is automatic
323
- - Consider re-uploading corrected version after deletion
324
-
325
- **Note:**
326
- File deletion is included - no credit consumption.
327
-
328
- Args:
329
- graph_id (str): Graph database identifier
330
- file_id (str): File ID
331
- token (Union[None, Unset, str]): JWT token for SSE authentication
332
- authorization (Union[None, Unset, str]):
333
-
334
- Raises:
335
- errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
336
- httpx.TimeoutException: If the request takes longer than Client.timeout.
337
-
338
- Returns:
339
- Response[Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]]
340
- """
203
+ """Delete File from Staging
204
+
205
+ Delete a file from S3 storage and database tracking.
206
+
207
+ Remove unwanted, duplicate, or incorrect files from staging tables before ingestion.
208
+ The file is deleted from both S3 and database tracking, and table statistics
209
+ are automatically recalculated.
210
+
211
+ **Use Cases:**
212
+ - Remove duplicate uploads
213
+ - Delete files with incorrect data
214
+ - Clean up failed uploads
215
+ - Fix data quality issues before ingestion
216
+ - Manage storage usage
217
+
218
+ **What Happens:**
219
+ 1. File deleted from S3 storage
220
+ 2. Database tracking record removed
221
+ 3. Table statistics recalculated (file count, size, row count)
222
+ 4. DuckDB automatically excludes file from future queries
223
+
224
+ **Security:**
225
+ - Write access required (verified via auth)
226
+ - Shared repositories block file deletions
227
+ - Full audit trail of deletion operations
228
+ - Cannot delete after ingestion to graph
229
+
230
+ **Important Notes:**
231
+ - Delete files before ingestion for best results
232
+ - Table statistics update automatically
233
+ - No need to refresh DuckDB - exclusion is automatic
234
+ - Consider re-uploading corrected version after deletion
235
+ - File deletion is included - no credit consumption
236
+
237
+ Args:
238
+ graph_id (str):
239
+ file_id (str): File ID
240
+
241
+ Raises:
242
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
243
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
244
+
245
+ Returns:
246
+ Response[Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]]
247
+ """
341
248
 
342
249
  kwargs = _get_kwargs(
343
250
  graph_id=graph_id,
344
251
  file_id=file_id,
345
- token=token,
346
- authorization=authorization,
347
252
  )
348
253
 
349
254
  response = await client.get_async_httpx_client().request(**kwargs)
@@ -356,82 +261,57 @@ async def asyncio(
356
261
  file_id: str,
357
262
  *,
358
263
  client: AuthenticatedClient,
359
- token: Union[None, Unset, str] = UNSET,
360
- authorization: Union[None, Unset, str] = UNSET,
361
264
  ) -> Optional[Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]]:
362
- r""" Delete File from Staging
363
-
364
- Delete a file from S3 storage and database tracking.
365
-
366
- **Purpose:**
367
- Remove unwanted, duplicate, or incorrect files from staging tables before ingestion.
368
- The file is deleted from both S3 and database tracking, and table statistics
369
- are automatically recalculated.
370
-
371
- **Use Cases:**
372
- - Remove duplicate uploads
373
- - Delete files with incorrect data
374
- - Clean up failed uploads
375
- - Fix data quality issues before ingestion
376
- - Manage storage usage
377
-
378
- **What Happens:**
379
- 1. File deleted from S3 storage
380
- 2. Database tracking record removed
381
- 3. Table statistics recalculated (file count, size, row count)
382
- 4. DuckDB automatically excludes file from future queries
383
-
384
- **Security:**
385
- - Write access required (verified via auth)
386
- - Shared repositories block file deletions
387
- - Full audit trail of deletion operations
388
- - Cannot delete after ingestion to graph
389
-
390
- **Example Response:**
391
- ```json
392
- {
393
- \"status\": \"deleted\",
394
- \"file_id\": \"f123\",
395
- \"file_name\": \"entities_batch1.parquet\",
396
- \"message\": \"File deleted successfully. DuckDB will automatically exclude it from queries.\"
397
- }
398
- ```
399
-
400
- **Example Usage:**
401
- ```bash
402
- curl -X DELETE -H \"Authorization: Bearer YOUR_TOKEN\" \
403
- https://api.robosystems.ai/v1/graphs/kg123/tables/files/f123
404
- ```
405
-
406
- **Tips:**
407
- - Delete files before ingestion for best results
408
- - Table statistics update automatically
409
- - No need to refresh DuckDB - exclusion is automatic
410
- - Consider re-uploading corrected version after deletion
411
-
412
- **Note:**
413
- File deletion is included - no credit consumption.
414
-
415
- Args:
416
- graph_id (str): Graph database identifier
417
- file_id (str): File ID
418
- token (Union[None, Unset, str]): JWT token for SSE authentication
419
- authorization (Union[None, Unset, str]):
420
-
421
- Raises:
422
- errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
423
- httpx.TimeoutException: If the request takes longer than Client.timeout.
424
-
425
- Returns:
426
- Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]
427
- """
265
+ """Delete File from Staging
266
+
267
+ Delete a file from S3 storage and database tracking.
268
+
269
+ Remove unwanted, duplicate, or incorrect files from staging tables before ingestion.
270
+ The file is deleted from both S3 and database tracking, and table statistics
271
+ are automatically recalculated.
272
+
273
+ **Use Cases:**
274
+ - Remove duplicate uploads
275
+ - Delete files with incorrect data
276
+ - Clean up failed uploads
277
+ - Fix data quality issues before ingestion
278
+ - Manage storage usage
279
+
280
+ **What Happens:**
281
+ 1. File deleted from S3 storage
282
+ 2. Database tracking record removed
283
+ 3. Table statistics recalculated (file count, size, row count)
284
+ 4. DuckDB automatically excludes file from future queries
285
+
286
+ **Security:**
287
+ - Write access required (verified via auth)
288
+ - Shared repositories block file deletions
289
+ - Full audit trail of deletion operations
290
+ - Cannot delete after ingestion to graph
291
+
292
+ **Important Notes:**
293
+ - Delete files before ingestion for best results
294
+ - Table statistics update automatically
295
+ - No need to refresh DuckDB - exclusion is automatic
296
+ - Consider re-uploading corrected version after deletion
297
+ - File deletion is included - no credit consumption
298
+
299
+ Args:
300
+ graph_id (str):
301
+ file_id (str): File ID
302
+
303
+ Raises:
304
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
305
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
306
+
307
+ Returns:
308
+ Union[Any, DeleteFileResponse, ErrorResponse, HTTPValidationError]
309
+ """
428
310
 
429
311
  return (
430
312
  await asyncio_detailed(
431
313
  graph_id=graph_id,
432
314
  file_id=file_id,
433
315
  client=client,
434
- token=token,
435
- authorization=authorization,
436
316
  )
437
317
  ).parsed