robosystems-client 0.1.11__py3-none-any.whl → 0.1.13__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 (69) hide show
  1. robosystems_client/api/agent/query_financial_agent.py +4 -4
  2. robosystems_client/api/backup/create_backup.py +1 -1
  3. robosystems_client/api/backup/export_backup.py +14 -19
  4. robosystems_client/api/backup/get_backup_download_url.py +1 -1
  5. robosystems_client/api/backup/get_backup_stats.py +19 -1
  6. robosystems_client/api/backup/list_backups.py +19 -1
  7. robosystems_client/api/backup/restore_backup.py +1 -1
  8. robosystems_client/api/copy/copy_data_to_graph.py +314 -0
  9. robosystems_client/api/{credits_ → graph_credits}/check_credit_balance.py +42 -20
  10. robosystems_client/api/graph_health/__init__.py +1 -0
  11. robosystems_client/api/{graph_status → graph_health}/get_database_health.py +1 -1
  12. robosystems_client/api/graph_info/__init__.py +1 -0
  13. robosystems_client/api/{graph_status → graph_info}/get_database_info.py +1 -1
  14. robosystems_client/api/graph_limits/__init__.py +1 -0
  15. robosystems_client/api/graph_limits/get_graph_limits.py +259 -0
  16. robosystems_client/api/subgraphs/__init__.py +1 -0
  17. robosystems_client/api/{billing/upgrade_graph_subscription_v1_graph_id_billing_subscription_upgrade_post.py → subgraphs/create_subgraph.py} +82 -36
  18. robosystems_client/api/subgraphs/delete_subgraph.py +317 -0
  19. robosystems_client/api/subgraphs/get_subgraph_info.py +300 -0
  20. robosystems_client/api/subgraphs/get_subgraph_quota.py +276 -0
  21. robosystems_client/api/{billing/get_credit_billing_info_v1_graph_id_billing_credits_get.py → subgraphs/list_subgraphs.py} +58 -32
  22. robosystems_client/api/user/get_all_credit_summaries.py +1 -1
  23. robosystems_client/extensions/README.md +2 -6
  24. robosystems_client/models/__init__.py +46 -10
  25. robosystems_client/models/copy_response.py +223 -0
  26. robosystems_client/models/{kuzu_backup_health_response_kuzubackuphealth.py → copy_response_error_details_type_0.py} +5 -5
  27. robosystems_client/models/copy_response_status.py +10 -0
  28. robosystems_client/models/create_subgraph_request.py +185 -0
  29. robosystems_client/models/create_subgraph_request_metadata_type_0.py +44 -0
  30. robosystems_client/models/credit_summary_response.py +0 -8
  31. robosystems_client/models/custom_schema_definition.py +2 -2
  32. robosystems_client/models/data_frame_copy_request.py +125 -0
  33. robosystems_client/models/data_frame_copy_request_format.py +10 -0
  34. robosystems_client/models/delete_subgraph_request.py +89 -0
  35. robosystems_client/models/delete_subgraph_response.py +120 -0
  36. robosystems_client/models/get_graph_limits_response_getgraphlimits.py +44 -0
  37. robosystems_client/models/list_subgraphs_response.py +148 -0
  38. robosystems_client/models/s3_copy_request.py +375 -0
  39. robosystems_client/models/s3_copy_request_file_format.py +12 -0
  40. robosystems_client/models/s3_copy_request_s3_url_style_type_0.py +9 -0
  41. robosystems_client/models/subgraph_quota_response.py +158 -0
  42. robosystems_client/models/subgraph_response.py +279 -0
  43. robosystems_client/models/subgraph_response_metadata_type_0.py +44 -0
  44. robosystems_client/models/subgraph_summary.py +155 -0
  45. robosystems_client/models/subgraph_type.py +11 -0
  46. robosystems_client/models/url_copy_request.py +157 -0
  47. robosystems_client/models/url_copy_request_file_format.py +10 -0
  48. robosystems_client/models/url_copy_request_headers_type_0.py +44 -0
  49. {robosystems_client-0.1.11.dist-info → robosystems_client-0.1.13.dist-info}/METADATA +1 -1
  50. {robosystems_client-0.1.11.dist-info → robosystems_client-0.1.13.dist-info}/RECORD +62 -39
  51. robosystems_client/api/backup/kuzu_backup_health.py +0 -202
  52. robosystems_client/api/billing/get_available_subscription_plans_v1_graph_id_billing_available_plans_get.py +0 -198
  53. robosystems_client/api/billing/get_graph_pricing_info_v1_graph_id_billing_pricing_get.py +0 -198
  54. robosystems_client/api/billing/get_graph_subscription_v1_graph_id_billing_subscription_get.py +0 -198
  55. robosystems_client/models/backup_export_request.py +0 -72
  56. robosystems_client/models/credit_check_request.py +0 -82
  57. robosystems_client/models/upgrade_subscription_request.py +0 -82
  58. /robosystems_client/api/{billing → copy}/__init__.py +0 -0
  59. /robosystems_client/api/{credits_ → graph_billing}/__init__.py +0 -0
  60. /robosystems_client/api/{billing → graph_billing}/get_current_graph_bill.py +0 -0
  61. /robosystems_client/api/{billing → graph_billing}/get_graph_billing_history.py +0 -0
  62. /robosystems_client/api/{billing → graph_billing}/get_graph_monthly_bill.py +0 -0
  63. /robosystems_client/api/{billing → graph_billing}/get_graph_usage_details.py +0 -0
  64. /robosystems_client/api/{graph_status → graph_credits}/__init__.py +0 -0
  65. /robosystems_client/api/{credits_ → graph_credits}/check_storage_limits.py +0 -0
  66. /robosystems_client/api/{credits_ → graph_credits}/get_credit_summary.py +0 -0
  67. /robosystems_client/api/{credits_ → graph_credits}/get_storage_usage.py +0 -0
  68. /robosystems_client/api/{credits_ → graph_credits}/list_credit_transactions.py +0 -0
  69. {robosystems_client-0.1.11.dist-info → robosystems_client-0.1.13.dist-info}/WHEEL +0 -0
@@ -0,0 +1,259 @@
1
+ from http import HTTPStatus
2
+ from typing import Any, Optional, Union, cast
3
+
4
+ import httpx
5
+
6
+ from ... import errors
7
+ from ...client import AuthenticatedClient, Client
8
+ from ...models.get_graph_limits_response_getgraphlimits import (
9
+ GetGraphLimitsResponseGetgraphlimits,
10
+ )
11
+ from ...models.http_validation_error import HTTPValidationError
12
+ from ...types import UNSET, Response, Unset
13
+
14
+
15
+ def _get_kwargs(
16
+ graph_id: str,
17
+ *,
18
+ authorization: Union[None, Unset, str] = UNSET,
19
+ auth_token: Union[None, Unset, str] = UNSET,
20
+ ) -> dict[str, Any]:
21
+ headers: dict[str, Any] = {}
22
+ if not isinstance(authorization, Unset):
23
+ headers["authorization"] = authorization
24
+
25
+ cookies = {}
26
+ if auth_token is not UNSET:
27
+ cookies["auth-token"] = auth_token
28
+
29
+ _kwargs: dict[str, Any] = {
30
+ "method": "get",
31
+ "url": f"/v1/{graph_id}/limits",
32
+ "cookies": cookies,
33
+ }
34
+
35
+ _kwargs["headers"] = headers
36
+ return _kwargs
37
+
38
+
39
+ def _parse_response(
40
+ *, client: Union[AuthenticatedClient, Client], response: httpx.Response
41
+ ) -> Optional[Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]]:
42
+ if response.status_code == 200:
43
+ response_200 = GetGraphLimitsResponseGetgraphlimits.from_dict(response.json())
44
+
45
+ return response_200
46
+ if response.status_code == 403:
47
+ response_403 = cast(Any, None)
48
+ return response_403
49
+ if response.status_code == 404:
50
+ response_404 = cast(Any, None)
51
+ return response_404
52
+ if response.status_code == 500:
53
+ response_500 = cast(Any, None)
54
+ return response_500
55
+ if response.status_code == 422:
56
+ response_422 = HTTPValidationError.from_dict(response.json())
57
+
58
+ return response_422
59
+ if client.raise_on_unexpected_status:
60
+ raise errors.UnexpectedStatus(response.status_code, response.content)
61
+ else:
62
+ return None
63
+
64
+
65
+ def _build_response(
66
+ *, client: Union[AuthenticatedClient, Client], response: httpx.Response
67
+ ) -> Response[Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]]:
68
+ return Response(
69
+ status_code=HTTPStatus(response.status_code),
70
+ content=response.content,
71
+ headers=response.headers,
72
+ parsed=_parse_response(client=client, response=response),
73
+ )
74
+
75
+
76
+ def sync_detailed(
77
+ graph_id: str,
78
+ *,
79
+ client: AuthenticatedClient,
80
+ authorization: Union[None, Unset, str] = UNSET,
81
+ auth_token: Union[None, Unset, str] = UNSET,
82
+ ) -> Response[Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]]:
83
+ """Get Graph Operational Limits
84
+
85
+ Get comprehensive operational limits for the graph database.
86
+
87
+ Returns all operational limits that apply to this graph including:
88
+ - **Storage Limits**: Maximum storage size and current usage
89
+ - **Query Limits**: Timeouts, complexity, row limits
90
+ - **Copy/Ingestion Limits**: File sizes, timeouts, concurrent operations
91
+ - **Backup Limits**: Frequency, retention, size limits
92
+ - **Rate Limits**: Requests per minute/hour based on tier
93
+ - **Credit Limits**: AI operation credits (if applicable)
94
+
95
+ This unified endpoint provides all limits in one place for easier client integration.
96
+
97
+ **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
98
+
99
+ Args:
100
+ graph_id (str): Graph database identifier (user graph or shared repository)
101
+ authorization (Union[None, Unset, str]):
102
+ auth_token (Union[None, Unset, str]):
103
+
104
+ Raises:
105
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
106
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
107
+
108
+ Returns:
109
+ Response[Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]]
110
+ """
111
+
112
+ kwargs = _get_kwargs(
113
+ graph_id=graph_id,
114
+ authorization=authorization,
115
+ auth_token=auth_token,
116
+ )
117
+
118
+ response = client.get_httpx_client().request(
119
+ **kwargs,
120
+ )
121
+
122
+ return _build_response(client=client, response=response)
123
+
124
+
125
+ def sync(
126
+ graph_id: str,
127
+ *,
128
+ client: AuthenticatedClient,
129
+ authorization: Union[None, Unset, str] = UNSET,
130
+ auth_token: Union[None, Unset, str] = UNSET,
131
+ ) -> Optional[Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]]:
132
+ """Get Graph Operational Limits
133
+
134
+ Get comprehensive operational limits for the graph database.
135
+
136
+ Returns all operational limits that apply to this graph including:
137
+ - **Storage Limits**: Maximum storage size and current usage
138
+ - **Query Limits**: Timeouts, complexity, row limits
139
+ - **Copy/Ingestion Limits**: File sizes, timeouts, concurrent operations
140
+ - **Backup Limits**: Frequency, retention, size limits
141
+ - **Rate Limits**: Requests per minute/hour based on tier
142
+ - **Credit Limits**: AI operation credits (if applicable)
143
+
144
+ This unified endpoint provides all limits in one place for easier client integration.
145
+
146
+ **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
147
+
148
+ Args:
149
+ graph_id (str): Graph database identifier (user graph or shared repository)
150
+ authorization (Union[None, Unset, str]):
151
+ auth_token (Union[None, Unset, str]):
152
+
153
+ Raises:
154
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
155
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
156
+
157
+ Returns:
158
+ Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]
159
+ """
160
+
161
+ return sync_detailed(
162
+ graph_id=graph_id,
163
+ client=client,
164
+ authorization=authorization,
165
+ auth_token=auth_token,
166
+ ).parsed
167
+
168
+
169
+ async def asyncio_detailed(
170
+ graph_id: str,
171
+ *,
172
+ client: AuthenticatedClient,
173
+ authorization: Union[None, Unset, str] = UNSET,
174
+ auth_token: Union[None, Unset, str] = UNSET,
175
+ ) -> Response[Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]]:
176
+ """Get Graph Operational Limits
177
+
178
+ Get comprehensive operational limits for the graph database.
179
+
180
+ Returns all operational limits that apply to this graph including:
181
+ - **Storage Limits**: Maximum storage size and current usage
182
+ - **Query Limits**: Timeouts, complexity, row limits
183
+ - **Copy/Ingestion Limits**: File sizes, timeouts, concurrent operations
184
+ - **Backup Limits**: Frequency, retention, size limits
185
+ - **Rate Limits**: Requests per minute/hour based on tier
186
+ - **Credit Limits**: AI operation credits (if applicable)
187
+
188
+ This unified endpoint provides all limits in one place for easier client integration.
189
+
190
+ **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
191
+
192
+ Args:
193
+ graph_id (str): Graph database identifier (user graph or shared repository)
194
+ authorization (Union[None, Unset, str]):
195
+ auth_token (Union[None, Unset, str]):
196
+
197
+ Raises:
198
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
199
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
200
+
201
+ Returns:
202
+ Response[Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]]
203
+ """
204
+
205
+ kwargs = _get_kwargs(
206
+ graph_id=graph_id,
207
+ authorization=authorization,
208
+ auth_token=auth_token,
209
+ )
210
+
211
+ response = await client.get_async_httpx_client().request(**kwargs)
212
+
213
+ return _build_response(client=client, response=response)
214
+
215
+
216
+ async def asyncio(
217
+ graph_id: str,
218
+ *,
219
+ client: AuthenticatedClient,
220
+ authorization: Union[None, Unset, str] = UNSET,
221
+ auth_token: Union[None, Unset, str] = UNSET,
222
+ ) -> Optional[Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]]:
223
+ """Get Graph Operational Limits
224
+
225
+ Get comprehensive operational limits for the graph database.
226
+
227
+ Returns all operational limits that apply to this graph including:
228
+ - **Storage Limits**: Maximum storage size and current usage
229
+ - **Query Limits**: Timeouts, complexity, row limits
230
+ - **Copy/Ingestion Limits**: File sizes, timeouts, concurrent operations
231
+ - **Backup Limits**: Frequency, retention, size limits
232
+ - **Rate Limits**: Requests per minute/hour based on tier
233
+ - **Credit Limits**: AI operation credits (if applicable)
234
+
235
+ This unified endpoint provides all limits in one place for easier client integration.
236
+
237
+ **Note**: Limits vary based on subscription tier (Standard, Enterprise, Premium).
238
+
239
+ Args:
240
+ graph_id (str): Graph database identifier (user graph or shared repository)
241
+ authorization (Union[None, Unset, str]):
242
+ auth_token (Union[None, Unset, str]):
243
+
244
+ Raises:
245
+ errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
246
+ httpx.TimeoutException: If the request takes longer than Client.timeout.
247
+
248
+ Returns:
249
+ Union[Any, GetGraphLimitsResponseGetgraphlimits, HTTPValidationError]
250
+ """
251
+
252
+ return (
253
+ await asyncio_detailed(
254
+ graph_id=graph_id,
255
+ client=client,
256
+ authorization=authorization,
257
+ auth_token=auth_token,
258
+ )
259
+ ).parsed
@@ -0,0 +1 @@
1
+ """Contains endpoint functions for accessing the API"""
@@ -5,15 +5,16 @@ import httpx
5
5
 
6
6
  from ... import errors
7
7
  from ...client import AuthenticatedClient, Client
8
+ from ...models.create_subgraph_request import CreateSubgraphRequest
8
9
  from ...models.http_validation_error import HTTPValidationError
9
- from ...models.upgrade_subscription_request import UpgradeSubscriptionRequest
10
+ from ...models.subgraph_response import SubgraphResponse
10
11
  from ...types import UNSET, Response, Unset
11
12
 
12
13
 
13
14
  def _get_kwargs(
14
15
  graph_id: str,
15
16
  *,
16
- body: UpgradeSubscriptionRequest,
17
+ body: CreateSubgraphRequest,
17
18
  authorization: Union[None, Unset, str] = UNSET,
18
19
  auth_token: Union[None, Unset, str] = UNSET,
19
20
  ) -> dict[str, Any]:
@@ -27,7 +28,7 @@ def _get_kwargs(
27
28
 
28
29
  _kwargs: dict[str, Any] = {
29
30
  "method": "post",
30
- "url": f"/v1/{graph_id}/billing/subscription/upgrade",
31
+ "url": f"/v1/{graph_id}/subgraphs",
31
32
  "cookies": cookies,
32
33
  }
33
34
 
@@ -41,10 +42,11 @@ def _get_kwargs(
41
42
 
42
43
  def _parse_response(
43
44
  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
44
- ) -> Optional[Union[Any, HTTPValidationError]]:
45
- if response.status_code == 200:
46
- response_200 = response.json()
47
- return response_200
45
+ ) -> Optional[Union[HTTPValidationError, SubgraphResponse]]:
46
+ if response.status_code == 201:
47
+ response_201 = SubgraphResponse.from_dict(response.json())
48
+
49
+ return response_201
48
50
  if response.status_code == 422:
49
51
  response_422 = HTTPValidationError.from_dict(response.json())
50
52
 
@@ -57,7 +59,7 @@ def _parse_response(
57
59
 
58
60
  def _build_response(
59
61
  *, client: Union[AuthenticatedClient, Client], response: httpx.Response
60
- ) -> Response[Union[Any, HTTPValidationError]]:
62
+ ) -> Response[Union[HTTPValidationError, SubgraphResponse]]:
61
63
  return Response(
62
64
  status_code=HTTPStatus(response.status_code),
63
65
  content=response.content,
@@ -70,26 +72,37 @@ def sync_detailed(
70
72
  graph_id: str,
71
73
  *,
72
74
  client: AuthenticatedClient,
73
- body: UpgradeSubscriptionRequest,
75
+ body: CreateSubgraphRequest,
74
76
  authorization: Union[None, Unset, str] = UNSET,
75
77
  auth_token: Union[None, Unset, str] = UNSET,
76
- ) -> Response[Union[Any, HTTPValidationError]]:
77
- """Upgrade Graph Subscription
78
+ ) -> Response[Union[HTTPValidationError, SubgraphResponse]]:
79
+ """Create Subgraph
80
+
81
+ Create a new subgraph within a parent graph.
82
+
83
+ **Requirements:**
84
+ - Valid authentication
85
+ - Parent graph must exist and be accessible to the user
86
+ - User must have 'admin' permission on the parent graph
87
+ - Parent graph tier must support subgraphs (Enterprise or Premium only)
88
+ - Must be within subgraph quota limits
89
+ - Subgraph name must be unique within the parent graph
78
90
 
79
- Upgrade subscription for a specific graph database.
91
+ **Returns:**
92
+ - Created subgraph details including its unique ID
80
93
 
81
94
  Args:
82
- graph_id (str): Graph database ID
95
+ graph_id (str): Parent graph ID (e.g., 'kg1a2b3c4d5')
83
96
  authorization (Union[None, Unset, str]):
84
97
  auth_token (Union[None, Unset, str]):
85
- body (UpgradeSubscriptionRequest): Request to upgrade a graph database subscription.
98
+ body (CreateSubgraphRequest): Request model for creating a subgraph.
86
99
 
87
100
  Raises:
88
101
  errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
89
102
  httpx.TimeoutException: If the request takes longer than Client.timeout.
90
103
 
91
104
  Returns:
92
- Response[Union[Any, HTTPValidationError]]
105
+ Response[Union[HTTPValidationError, SubgraphResponse]]
93
106
  """
94
107
 
95
108
  kwargs = _get_kwargs(
@@ -110,26 +123,37 @@ def sync(
110
123
  graph_id: str,
111
124
  *,
112
125
  client: AuthenticatedClient,
113
- body: UpgradeSubscriptionRequest,
126
+ body: CreateSubgraphRequest,
114
127
  authorization: Union[None, Unset, str] = UNSET,
115
128
  auth_token: Union[None, Unset, str] = UNSET,
116
- ) -> Optional[Union[Any, HTTPValidationError]]:
117
- """Upgrade Graph Subscription
129
+ ) -> Optional[Union[HTTPValidationError, SubgraphResponse]]:
130
+ """Create Subgraph
131
+
132
+ Create a new subgraph within a parent graph.
133
+
134
+ **Requirements:**
135
+ - Valid authentication
136
+ - Parent graph must exist and be accessible to the user
137
+ - User must have 'admin' permission on the parent graph
138
+ - Parent graph tier must support subgraphs (Enterprise or Premium only)
139
+ - Must be within subgraph quota limits
140
+ - Subgraph name must be unique within the parent graph
118
141
 
119
- Upgrade subscription for a specific graph database.
142
+ **Returns:**
143
+ - Created subgraph details including its unique ID
120
144
 
121
145
  Args:
122
- graph_id (str): Graph database ID
146
+ graph_id (str): Parent graph ID (e.g., 'kg1a2b3c4d5')
123
147
  authorization (Union[None, Unset, str]):
124
148
  auth_token (Union[None, Unset, str]):
125
- body (UpgradeSubscriptionRequest): Request to upgrade a graph database subscription.
149
+ body (CreateSubgraphRequest): Request model for creating a subgraph.
126
150
 
127
151
  Raises:
128
152
  errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
129
153
  httpx.TimeoutException: If the request takes longer than Client.timeout.
130
154
 
131
155
  Returns:
132
- Union[Any, HTTPValidationError]
156
+ Union[HTTPValidationError, SubgraphResponse]
133
157
  """
134
158
 
135
159
  return sync_detailed(
@@ -145,26 +169,37 @@ async def asyncio_detailed(
145
169
  graph_id: str,
146
170
  *,
147
171
  client: AuthenticatedClient,
148
- body: UpgradeSubscriptionRequest,
172
+ body: CreateSubgraphRequest,
149
173
  authorization: Union[None, Unset, str] = UNSET,
150
174
  auth_token: Union[None, Unset, str] = UNSET,
151
- ) -> Response[Union[Any, HTTPValidationError]]:
152
- """Upgrade Graph Subscription
175
+ ) -> Response[Union[HTTPValidationError, SubgraphResponse]]:
176
+ """Create Subgraph
153
177
 
154
- Upgrade subscription for a specific graph database.
178
+ Create a new subgraph within a parent graph.
179
+
180
+ **Requirements:**
181
+ - Valid authentication
182
+ - Parent graph must exist and be accessible to the user
183
+ - User must have 'admin' permission on the parent graph
184
+ - Parent graph tier must support subgraphs (Enterprise or Premium only)
185
+ - Must be within subgraph quota limits
186
+ - Subgraph name must be unique within the parent graph
187
+
188
+ **Returns:**
189
+ - Created subgraph details including its unique ID
155
190
 
156
191
  Args:
157
- graph_id (str): Graph database ID
192
+ graph_id (str): Parent graph ID (e.g., 'kg1a2b3c4d5')
158
193
  authorization (Union[None, Unset, str]):
159
194
  auth_token (Union[None, Unset, str]):
160
- body (UpgradeSubscriptionRequest): Request to upgrade a graph database subscription.
195
+ body (CreateSubgraphRequest): Request model for creating a subgraph.
161
196
 
162
197
  Raises:
163
198
  errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
164
199
  httpx.TimeoutException: If the request takes longer than Client.timeout.
165
200
 
166
201
  Returns:
167
- Response[Union[Any, HTTPValidationError]]
202
+ Response[Union[HTTPValidationError, SubgraphResponse]]
168
203
  """
169
204
 
170
205
  kwargs = _get_kwargs(
@@ -183,26 +218,37 @@ async def asyncio(
183
218
  graph_id: str,
184
219
  *,
185
220
  client: AuthenticatedClient,
186
- body: UpgradeSubscriptionRequest,
221
+ body: CreateSubgraphRequest,
187
222
  authorization: Union[None, Unset, str] = UNSET,
188
223
  auth_token: Union[None, Unset, str] = UNSET,
189
- ) -> Optional[Union[Any, HTTPValidationError]]:
190
- """Upgrade Graph Subscription
224
+ ) -> Optional[Union[HTTPValidationError, SubgraphResponse]]:
225
+ """Create Subgraph
226
+
227
+ Create a new subgraph within a parent graph.
228
+
229
+ **Requirements:**
230
+ - Valid authentication
231
+ - Parent graph must exist and be accessible to the user
232
+ - User must have 'admin' permission on the parent graph
233
+ - Parent graph tier must support subgraphs (Enterprise or Premium only)
234
+ - Must be within subgraph quota limits
235
+ - Subgraph name must be unique within the parent graph
191
236
 
192
- Upgrade subscription for a specific graph database.
237
+ **Returns:**
238
+ - Created subgraph details including its unique ID
193
239
 
194
240
  Args:
195
- graph_id (str): Graph database ID
241
+ graph_id (str): Parent graph ID (e.g., 'kg1a2b3c4d5')
196
242
  authorization (Union[None, Unset, str]):
197
243
  auth_token (Union[None, Unset, str]):
198
- body (UpgradeSubscriptionRequest): Request to upgrade a graph database subscription.
244
+ body (CreateSubgraphRequest): Request model for creating a subgraph.
199
245
 
200
246
  Raises:
201
247
  errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
202
248
  httpx.TimeoutException: If the request takes longer than Client.timeout.
203
249
 
204
250
  Returns:
205
- Union[Any, HTTPValidationError]
251
+ Union[HTTPValidationError, SubgraphResponse]
206
252
  """
207
253
 
208
254
  return (