universal-mcp-applications 0.1.13__py3-none-any.whl → 0.1.14__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 universal-mcp-applications might be problematic. Click here for more details.

Files changed (54) hide show
  1. universal_mcp/applications/aws_s3/app.py +71 -71
  2. universal_mcp/applications/calendly/app.py +199 -199
  3. universal_mcp/applications/canva/app.py +189 -189
  4. universal_mcp/applications/domain_checker/app.py +31 -24
  5. universal_mcp/applications/e2b/app.py +6 -7
  6. universal_mcp/applications/elevenlabs/app.py +24 -20
  7. universal_mcp/applications/exa/app.py +25 -20
  8. universal_mcp/applications/falai/app.py +44 -41
  9. universal_mcp/applications/file_system/app.py +20 -12
  10. universal_mcp/applications/firecrawl/app.py +46 -47
  11. universal_mcp/applications/fireflies/app.py +79 -79
  12. universal_mcp/applications/fpl/app.py +83 -74
  13. universal_mcp/applications/github/README.md +0 -1028
  14. universal_mcp/applications/github/app.py +55 -50227
  15. universal_mcp/applications/google_calendar/app.py +63 -65
  16. universal_mcp/applications/google_docs/app.py +78 -78
  17. universal_mcp/applications/google_drive/app.py +361 -440
  18. universal_mcp/applications/google_gemini/app.py +34 -17
  19. universal_mcp/applications/google_mail/app.py +117 -117
  20. universal_mcp/applications/google_searchconsole/app.py +41 -47
  21. universal_mcp/applications/google_sheet/app.py +157 -164
  22. universal_mcp/applications/http_tools/app.py +16 -16
  23. universal_mcp/applications/linkedin/app.py +26 -31
  24. universal_mcp/applications/ms_teams/app.py +190 -190
  25. universal_mcp/applications/openai/app.py +55 -56
  26. universal_mcp/applications/outlook/app.py +57 -57
  27. universal_mcp/applications/perplexity/app.py +17 -17
  28. universal_mcp/applications/reddit/app.py +225 -4053
  29. universal_mcp/applications/replicate/app.py +40 -42
  30. universal_mcp/applications/resend/app.py +157 -154
  31. universal_mcp/applications/scraper/app.py +24 -24
  32. universal_mcp/applications/serpapi/app.py +18 -20
  33. universal_mcp/applications/sharepoint/app.py +46 -36
  34. universal_mcp/applications/slack/app.py +66 -66
  35. universal_mcp/applications/tavily/app.py +7 -7
  36. universal_mcp/applications/twitter/api_segments/compliance_api.py +17 -20
  37. universal_mcp/applications/twitter/api_segments/dm_conversations_api.py +35 -40
  38. universal_mcp/applications/twitter/api_segments/dm_events_api.py +18 -21
  39. universal_mcp/applications/twitter/api_segments/likes_api.py +19 -22
  40. universal_mcp/applications/twitter/api_segments/lists_api.py +59 -68
  41. universal_mcp/applications/twitter/api_segments/spaces_api.py +36 -42
  42. universal_mcp/applications/twitter/api_segments/trends_api.py +7 -8
  43. universal_mcp/applications/twitter/api_segments/tweets_api.py +159 -185
  44. universal_mcp/applications/twitter/api_segments/usage_api.py +5 -6
  45. universal_mcp/applications/twitter/api_segments/users_api.py +230 -264
  46. universal_mcp/applications/unipile/app.py +99 -105
  47. universal_mcp/applications/whatsapp/app.py +86 -82
  48. universal_mcp/applications/whatsapp_business/app.py +147 -147
  49. universal_mcp/applications/youtube/app.py +290 -290
  50. universal_mcp/applications/zenquotes/app.py +6 -6
  51. {universal_mcp_applications-0.1.13.dist-info → universal_mcp_applications-0.1.14.dist-info}/METADATA +1 -1
  52. {universal_mcp_applications-0.1.13.dist-info → universal_mcp_applications-0.1.14.dist-info}/RECORD +54 -54
  53. {universal_mcp_applications-0.1.13.dist-info → universal_mcp_applications-0.1.14.dist-info}/WHEEL +0 -0
  54. {universal_mcp_applications-0.1.13.dist-info → universal_mcp_applications-0.1.14.dist-info}/licenses/LICENSE +0 -0
@@ -9,16 +9,16 @@ class CanvaApp(APIApplication):
9
9
  super().__init__(name="canva", integration=integration, **kwargs)
10
10
  self.base_url = "https://api.canva.com/rest"
11
11
 
12
- def v1_apps_appid_jwks(self, appId) -> dict[str, Any]:
12
+ def get_app_jwks(self, appId) -> dict[str, Any]:
13
13
  """
14
- Retrieves the JSON Web Key Set (JWKS) containing public keys for verifying JWTs associated with the specified application.
15
-
14
+ Retrieves the JSON Web Key Set (JWKS) for a given application ID. The JWKS contains public keys essential for verifying the authenticity of JSON Web Tokens (JWTs) issued by the application, ensuring secure communication.
15
+
16
16
  Args:
17
17
  appId (string): appId
18
-
18
+
19
19
  Returns:
20
20
  dict[str, Any]: OK
21
-
21
+
22
22
  Tags:
23
23
  app
24
24
  """
@@ -30,16 +30,16 @@ class CanvaApp(APIApplication):
30
30
  response.raise_for_status()
31
31
  return response.json()
32
32
 
33
- def v1_assets_assetid1(self, assetId) -> dict[str, Any]:
33
+ def get_asset(self, assetId) -> dict[str, Any]:
34
34
  """
35
- Retrieves the details of a specific asset using the provided assetId and returns the asset data.
36
-
35
+ Fetches the details of a specific asset using its unique identifier. This function performs a GET request to retrieve asset data, distinguishing it from other functions that update (`v1_assets_assetid2`, `v1_assets_assetid3`) or delete (`v1_assets_assetid`) assets at the same endpoint.
36
+
37
37
  Args:
38
38
  assetId (string): assetId
39
-
39
+
40
40
  Returns:
41
41
  dict[str, Any]: OK
42
-
42
+
43
43
  Tags:
44
44
  asset
45
45
  """
@@ -51,10 +51,10 @@ class CanvaApp(APIApplication):
51
51
  response.raise_for_status()
52
52
  return response.json()
53
53
 
54
- def v1_assets_assetid3(self, assetId, name=None, tags=None) -> dict[str, Any]:
54
+ def post_update_asset(self, assetId, name=None, tags=None) -> dict[str, Any]:
55
55
  """
56
- Updates an asset using the "POST" method at the "/v1/assets/{assetId}" endpoint and returns a status message.
57
-
56
+ Updates an asset's name and tags by its ID using an HTTP POST request. This method is distinct from the PATCH-based update function (`v1_assets_assetid2`), which performs a similar action on the same `/v1/assets/{assetId}` endpoint.
57
+
58
58
  Args:
59
59
  assetId (string): assetId
60
60
  name (string): name Example: '<string>'.
@@ -69,10 +69,10 @@ class CanvaApp(APIApplication):
69
69
  ]
70
70
  }
71
71
  ```
72
-
72
+
73
73
  Returns:
74
74
  dict[str, Any]: OK
75
-
75
+
76
76
  Tags:
77
77
  asset
78
78
  """
@@ -89,16 +89,16 @@ class CanvaApp(APIApplication):
89
89
  response.raise_for_status()
90
90
  return response.json()
91
91
 
92
- def v1_assets_assetid(self, assetId) -> Any:
92
+ def delete_asset(self, assetId) -> Any:
93
93
  """
94
- Deletes an asset by its unique identifier and returns a success status upon completion.
95
-
94
+ Deletes a specific Canva asset identified by its unique ID. This function sends an HTTP DELETE request to the `/v1/assets/{assetId}` endpoint to permanently remove the resource, returning the API's confirmation response upon successful completion.
95
+
96
96
  Args:
97
97
  assetId (string): assetId
98
-
98
+
99
99
  Returns:
100
100
  Any: OK
101
-
101
+
102
102
  Tags:
103
103
  asset
104
104
  """
@@ -110,10 +110,10 @@ class CanvaApp(APIApplication):
110
110
  response.raise_for_status()
111
111
  return response.json()
112
112
 
113
- def v1_assets_assetid2(self, assetId, name=None, tags=None) -> dict[str, Any]:
113
+ def patch_asset(self, assetId, name=None, tags=None) -> dict[str, Any]:
114
114
  """
115
- Updates specific properties of an asset identified by its ID and returns the operation status.
116
-
115
+ Partially updates an asset by its ID using an HTTP PATCH request to modify specific fields like name or tags. Unlike `v1_assets_assetid3` which uses POST, this method applies incremental changes, returning the updated asset data upon completion.
116
+
117
117
  Args:
118
118
  assetId (string): assetId
119
119
  name (string): name Example: '<string>'.
@@ -128,10 +128,10 @@ class CanvaApp(APIApplication):
128
128
  ]
129
129
  }
130
130
  ```
131
-
131
+
132
132
  Returns:
133
133
  dict[str, Any]: OK
134
-
134
+
135
135
  Tags:
136
136
  asset
137
137
  """
@@ -148,16 +148,16 @@ class CanvaApp(APIApplication):
148
148
  response.raise_for_status()
149
149
  return response.json()
150
150
 
151
- def v1_assets_upload(self, request_body=None) -> dict[str, Any]:
151
+ def upload_asset(self, request_body=None) -> dict[str, Any]:
152
152
  """
153
- Uploads an asset with provided metadata to the server and returns a success or error status.
154
-
153
+ Uploads an asset by sending its data to the `/v1/assets/upload` endpoint. This function performs a direct, synchronous upload, returning a confirmation. It differs from `v1_asset_uploads`, which initiates an asynchronous upload job tracked by an ID.
154
+
155
155
  Args:
156
156
  request_body (dict | None): Optional dictionary for arbitrary request body data.
157
-
157
+
158
158
  Returns:
159
159
  dict[str, Any]: OK
160
-
160
+
161
161
  Tags:
162
162
  asset
163
163
  """
@@ -167,16 +167,16 @@ class CanvaApp(APIApplication):
167
167
  response.raise_for_status()
168
168
  return response.json()
169
169
 
170
- def v1_asset_uploads(self, request_body=None) -> dict[str, Any]:
170
+ def create_asset_upload_job(self, request_body=None) -> dict[str, Any]:
171
171
  """
172
- Initiates an asset upload using the "POST" method at the "/v1/asset-uploads" path, accepting asset metadata in the header and handling responses for successful and failed uploads.
173
-
172
+ Initiates an asynchronous asset upload by creating an upload job. This method returns details, like a job ID, for subsequent steps. It differs from `v1_assets_upload`, which targets a direct, synchronous upload endpoint.
173
+
174
174
  Args:
175
175
  request_body (dict | None): Optional dictionary for arbitrary request body data.
176
-
176
+
177
177
  Returns:
178
178
  dict[str, Any]: OK
179
-
179
+
180
180
  Tags:
181
181
  asset
182
182
  """
@@ -186,16 +186,16 @@ class CanvaApp(APIApplication):
186
186
  response.raise_for_status()
187
187
  return response.json()
188
188
 
189
- def v1_asset_uploads_jobid(self, jobId) -> dict[str, Any]:
189
+ def get_asset_upload_job_status(self, jobId) -> dict[str, Any]:
190
190
  """
191
- Retrieves the status and results of an asset upload job identified by the job ID.
192
-
191
+ Retrieves the status and results of an asynchronous asset upload job using its unique job ID. This allows for checking the outcome of an upload initiated by `v1_asset_uploads`, returning details on its completion and any resulting asset information.
192
+
193
193
  Args:
194
194
  jobId (string): jobId
195
-
195
+
196
196
  Returns:
197
197
  dict[str, Any]: OK
198
-
198
+
199
199
  Tags:
200
200
  asset
201
201
  """
@@ -207,12 +207,12 @@ class CanvaApp(APIApplication):
207
207
  response.raise_for_status()
208
208
  return response.json()
209
209
 
210
- def v1_autofills(
210
+ def create_autofill_job(
211
211
  self, brand_template_id=None, data=None, preview=None, title=None
212
212
  ) -> dict[str, Any]:
213
213
  """
214
- Triggers an autofill operation using the API at the "/v1/autofills" path, sending data via the POST method, and returns a response indicating success or failure.
215
-
214
+ Initiates an autofill job to create a new design by populating a brand template with provided data. It sends a POST request with the template ID, data, and title, returning the details of the newly created job.
215
+
216
216
  Args:
217
217
  brand_template_id (string): brand_template_id Example: '<string>'.
218
218
  data (object): data
@@ -236,10 +236,10 @@ class CanvaApp(APIApplication):
236
236
  "title": "<string>"
237
237
  }
238
238
  ```
239
-
239
+
240
240
  Returns:
241
241
  dict[str, Any]: OK
242
-
242
+
243
243
  Tags:
244
244
  autofill
245
245
  """
@@ -256,16 +256,16 @@ class CanvaApp(APIApplication):
256
256
  response.raise_for_status()
257
257
  return response.json()
258
258
 
259
- def v1_autofills_jobid(self, jobId) -> dict[str, Any]:
259
+ def get_autofill_job_status(self, jobId) -> dict[str, Any]:
260
260
  """
261
- Retrieves autofill data for a job identified by the specified jobId using the GET method at the "/v1/autofills/{jobId}" endpoint.
262
-
261
+ Retrieves the status and results of an asynchronous autofill job by its unique `jobId`. This function is used to check the outcome of a template population operation initiated by the `v1_autofills` method.
262
+
263
263
  Args:
264
264
  jobId (string): jobId
265
-
265
+
266
266
  Returns:
267
267
  dict[str, Any]: OK
268
-
268
+
269
269
  Tags:
270
270
  autofill
271
271
  """
@@ -277,12 +277,12 @@ class CanvaApp(APIApplication):
277
277
  response.raise_for_status()
278
278
  return response.json()
279
279
 
280
- def v1_brand_templates(
280
+ def list_brand_templates(
281
281
  self, query=None, continuation=None, ownership=None, sort_by=None
282
282
  ) -> dict[str, Any]:
283
283
  """
284
- Retrieves a list of brand templates based on query parameters such as ownership and sorting options using the "GET" method at the "/v1/brand-templates" path.
285
-
284
+ Searches for and retrieves a paginated list of brand templates. Results can be filtered by ownership and sorted by relevance, modification date, or title. A continuation token can be used to fetch subsequent pages of templates.
285
+
286
286
  Args:
287
287
  query (string): Lets you search the brand templates available to the user using a search term or terms. Example: '<string>'.
288
288
  continuation (string): If the success response contains a continuation token, the user has access to more
@@ -301,10 +301,10 @@ class CanvaApp(APIApplication):
301
301
  - `MODIFIED_ASCENDING`: Sort results by the date last modified in ascending order.
302
302
  - `TITLE_DESCENDING`: Sort results by title in descending order.
303
303
  - `TITLE_ASCENDING`: Sort results by title in ascending order. Example: '<string>'.
304
-
304
+
305
305
  Returns:
306
306
  dict[str, Any]: OK
307
-
307
+
308
308
  Tags:
309
309
  brand_template, important
310
310
  """
@@ -323,16 +323,16 @@ class CanvaApp(APIApplication):
323
323
  response.raise_for_status()
324
324
  return response.json()
325
325
 
326
- def v1_brand_templates_brandtemplateid(self, brandTemplateId) -> dict[str, Any]:
326
+ def get_brand_template_by_id(self, brandTemplateId) -> dict[str, Any]:
327
327
  """
328
- Retrieves metadata for a specific brand template using its unique identifier.
329
-
328
+ Retrieves the complete metadata for a specific brand template using its unique identifier. This is distinct from `v1_brand_templates`, which lists multiple templates, and `v1_brand_templates_brandtemplateid_dataset`, which gets only a template's dataset.
329
+
330
330
  Args:
331
331
  brandTemplateId (string): brandTemplateId
332
-
332
+
333
333
  Returns:
334
334
  dict[str, Any]: OK
335
-
335
+
336
336
  Tags:
337
337
  brand_template
338
338
  """
@@ -344,18 +344,18 @@ class CanvaApp(APIApplication):
344
344
  response.raise_for_status()
345
345
  return response.json()
346
346
 
347
- def v1_brand_templates_brandtemplateid_dataset(
347
+ def get_brand_template_dataset(
348
348
  self, brandTemplateId
349
349
  ) -> dict[str, Any]:
350
350
  """
351
- Retrieves the dataset definition of a brand template, including data field names and types, allowing for the identification of autofillable fields.
352
-
351
+ Retrieves the dataset for a specific brand template by its ID. The dataset defines the names and types of autofillable fields, which is essential for programmatically populating the template with data.
352
+
353
353
  Args:
354
354
  brandTemplateId (string): brandTemplateId
355
-
355
+
356
356
  Returns:
357
357
  dict[str, Any]: OK
358
-
358
+
359
359
  Tags:
360
360
  brand_template
361
361
  """
@@ -367,12 +367,12 @@ class CanvaApp(APIApplication):
367
367
  response.raise_for_status()
368
368
  return response.json()
369
369
 
370
- def v1_comments(
370
+ def create_comment(
371
371
  self, assignee_id=None, attached_to=None, message=None
372
372
  ) -> dict[str, Any]:
373
373
  """
374
- Creates a new comment and returns a status message.
375
-
374
+ Creates a new top-level comment attached to a specific resource, such as a design. It allows for an optional assignee and a message body, sending a POST request to the `/v1/comments` endpoint and returning the details of the newly created comment.
375
+
376
376
  Args:
377
377
  assignee_id (string): assignee_id Example: '<string>'.
378
378
  attached_to (object): attached_to
@@ -388,10 +388,10 @@ class CanvaApp(APIApplication):
388
388
  "message": "<string>"
389
389
  }
390
390
  ```
391
-
391
+
392
392
  Returns:
393
393
  dict[str, Any]: OK
394
-
394
+
395
395
  Tags:
396
396
  comment
397
397
  """
@@ -407,12 +407,12 @@ class CanvaApp(APIApplication):
407
407
  response.raise_for_status()
408
408
  return response.json()
409
409
 
410
- def v1_comments_commentid_replies(
410
+ def create_comment_reply(
411
411
  self, commentId, attached_to=None, message=None
412
412
  ) -> dict[str, Any]:
413
413
  """
414
- Creates a new reply to a comment using the "POST" method.
415
-
414
+ Creates a reply to a specific comment, identified by `commentId`. It sends a POST request with the reply's message and attachment details to the `/v1/comments/{commentId}/replies` endpoint, adding a threaded response to an existing comment.
415
+
416
416
  Args:
417
417
  commentId (string): commentId
418
418
  attached_to (object): attached_to
@@ -427,10 +427,10 @@ class CanvaApp(APIApplication):
427
427
  "message": "<string>"
428
428
  }
429
429
  ```
430
-
430
+
431
431
  Returns:
432
432
  dict[str, Any]: OK
433
-
433
+
434
434
  Tags:
435
435
  comment
436
436
  """
@@ -447,19 +447,19 @@ class CanvaApp(APIApplication):
447
447
  response.raise_for_status()
448
448
  return response.json()
449
449
 
450
- def v1_designs_designid_comments_commentid(
450
+ def get_design_comment(
451
451
  self, designId, commentId
452
452
  ) -> dict[str, Any]:
453
453
  """
454
- Retrieves a specific comment from a design using the provided design ID and comment ID.
455
-
454
+ Fetches a specific comment from a design using both the design and comment IDs. Unlike other functions that create comments or replies, this method exclusively retrieves the data for a single, existing comment by making a GET request to the API.
455
+
456
456
  Args:
457
457
  designId (string): designId
458
458
  commentId (string): commentId
459
-
459
+
460
460
  Returns:
461
461
  dict[str, Any]: OK
462
-
462
+
463
463
  Tags:
464
464
  comment
465
465
  """
@@ -473,13 +473,13 @@ class CanvaApp(APIApplication):
473
473
  response.raise_for_status()
474
474
  return response.json()
475
475
 
476
- def v1_connect_keys(self) -> dict[str, Any]:
476
+ def get_connection_keys(self) -> dict[str, Any]:
477
477
  """
478
- Retrieves a list of connection keys associated with the current user or application.
479
-
478
+ Fetches a list of connection keys for the authenticated user or application from the `/v1/connect/keys` endpoint. These keys are used for establishing secure connections or integrations with the Canva API.
479
+
480
480
  Returns:
481
481
  dict[str, Any]: OK
482
-
482
+
483
483
  Tags:
484
484
  connect
485
485
  """
@@ -489,12 +489,12 @@ class CanvaApp(APIApplication):
489
489
  response.raise_for_status()
490
490
  return response.json()
491
491
 
492
- def v1_designs(
492
+ def list_designs(
493
493
  self, query=None, continuation=None, ownership=None, sort_by=None
494
494
  ) -> dict[str, Any]:
495
495
  """
496
- Retrieves a list of designs based on query parameters, including query, continuation, ownership, and sort order, using the GET method at the "/v1/designs" endpoint.
497
-
496
+ Retrieves a list of designs available to the user. Results can be filtered by a search query, ownership status, and sort order. It supports pagination for large datasets using a continuation token to fetch multiple designs.
497
+
498
498
  Args:
499
499
  query (string): Lets you search the user's designs, and designs shared with the user, using a search term or terms. Example: '<string>'.
500
500
  continuation (string): If the success response contains a continuation token, the list contains more designs
@@ -511,10 +511,10 @@ class CanvaApp(APIApplication):
511
511
  - `modified_ascending`: Sort results by the date last modified in ascending order.
512
512
  - `title_descending`: Sort results by title in descending order.
513
513
  - `title_ascending`: Sort results by title in ascending order. Example: '<string>'.
514
-
514
+
515
515
  Returns:
516
516
  dict[str, Any]: OK
517
-
517
+
518
518
  Tags:
519
519
  design, important
520
520
  """
@@ -533,12 +533,12 @@ class CanvaApp(APIApplication):
533
533
  response.raise_for_status()
534
534
  return response.json()
535
535
 
536
- def v1_designs1(
536
+ def create_design(
537
537
  self, asset_id=None, design_type=None, title=None
538
538
  ) -> dict[str, Any]:
539
539
  """
540
- Creates a new design resource and returns the result of the operation.
541
-
540
+ Creates a new design from an asset. This function sends a POST request to the `/v1/designs` endpoint with the asset ID, design type, and title, returning the data for the newly created design resource.
541
+
542
542
  Args:
543
543
  asset_id (string): asset_id Example: '<string>'.
544
544
  design_type (object): design_type
@@ -554,10 +554,10 @@ class CanvaApp(APIApplication):
554
554
  "title": "<string>"
555
555
  }
556
556
  ```
557
-
557
+
558
558
  Returns:
559
559
  dict[str, Any]: OK
560
-
560
+
561
561
  Tags:
562
562
  design
563
563
  """
@@ -573,16 +573,16 @@ class CanvaApp(APIApplication):
573
573
  response.raise_for_status()
574
574
  return response.json()
575
575
 
576
- def v1_designs_designid(self, designId) -> dict[str, Any]:
576
+ def get_design(self, designId) -> dict[str, Any]:
577
577
  """
578
- Retrieves a specific design by its ID using the GET method at the "/v1/designs/{designId}" endpoint.
579
-
578
+ Fetches the details for a single, specific design using its unique identifier. This function retrieves one design, distinguishing it from `v1_designs` which lists multiple designs and `v1_designs1` which creates a new design.
579
+
580
580
  Args:
581
581
  designId (string): designId
582
-
582
+
583
583
  Returns:
584
584
  dict[str, Any]: OK
585
-
585
+
586
586
  Tags:
587
587
  design
588
588
  """
@@ -594,16 +594,16 @@ class CanvaApp(APIApplication):
594
594
  response.raise_for_status()
595
595
  return response.json()
596
596
 
597
- def v1_imports(self, request_body=None) -> dict[str, Any]:
597
+ def create_design_import_job(self, request_body=None) -> dict[str, Any]:
598
598
  """
599
- Initiates a data import process with the provided metadata in the request header and returns an appropriate response.
600
-
599
+ Initiates a job to import a file (e.g., PDF, PPTX) for creating a new Canva design. This function sends a POST request to the `/v1/imports` endpoint and returns details of the created import job, including a job ID for status tracking.
600
+
601
601
  Args:
602
602
  request_body (dict | None): Optional dictionary for arbitrary request body data.
603
-
603
+
604
604
  Returns:
605
605
  dict[str, Any]: OK
606
-
606
+
607
607
  Tags:
608
608
  design_import
609
609
  """
@@ -613,16 +613,16 @@ class CanvaApp(APIApplication):
613
613
  response.raise_for_status()
614
614
  return response.json()
615
615
 
616
- def v1_imports_jobid(self, jobId) -> dict[str, Any]:
616
+ def get_design_import_status(self, jobId) -> dict[str, Any]:
617
617
  """
618
- Retrieves the status and details of a specific import job identified by its job ID.
619
-
618
+ Retrieves the status and results of a specific design import job using its unique `jobId`. This function checks the outcome of an import process initiated by the `v1_imports` method, returning details about the job's progress and final state.
619
+
620
620
  Args:
621
621
  jobId (string): jobId
622
-
622
+
623
623
  Returns:
624
624
  dict[str, Any]: OK
625
-
625
+
626
626
  Tags:
627
627
  design_import
628
628
  """
@@ -634,10 +634,10 @@ class CanvaApp(APIApplication):
634
634
  response.raise_for_status()
635
635
  return response.json()
636
636
 
637
- def v1_exports(self, design_id=None, format=None) -> dict[str, Any]:
637
+ def create_design_export(self, design_id=None, format=None) -> dict[str, Any]:
638
638
  """
639
- Initiates an export process through the API and returns status codes for success or failure.
640
-
639
+ Initiates an export job for a specified design based on its ID and format details (e.g., file type, quality). It returns the export job's details, including an ID used to track its status with `v1_exports_exportid`.
640
+
641
641
  Args:
642
642
  design_id (string): design_id Example: '<string>'.
643
643
  format (object): format
@@ -656,10 +656,10 @@ class CanvaApp(APIApplication):
656
656
  }
657
657
  }
658
658
  ```
659
-
659
+
660
660
  Returns:
661
661
  dict[str, Any]: OK
662
-
662
+
663
663
  Tags:
664
664
  export
665
665
  """
@@ -674,16 +674,16 @@ class CanvaApp(APIApplication):
674
674
  response.raise_for_status()
675
675
  return response.json()
676
676
 
677
- def v1_exports_exportid(self, exportId) -> dict[str, Any]:
677
+ def get_export_job_status(self, exportId) -> dict[str, Any]:
678
678
  """
679
- Retrieves export details by ID using the "GET" method at the path "/v1/exports/{exportId}" and returns a response.
680
-
679
+ Retrieves the status and results of a specific design export job using its unique ID. This is used to check on an export initiated by the `v1_exports` function and to obtain download links for the completed file.
680
+
681
681
  Args:
682
682
  exportId (string): exportId
683
-
683
+
684
684
  Returns:
685
685
  dict[str, Any]: OK
686
-
686
+
687
687
  Tags:
688
688
  export
689
689
  """
@@ -695,16 +695,16 @@ class CanvaApp(APIApplication):
695
695
  response.raise_for_status()
696
696
  return response.json()
697
697
 
698
- def v1_folders_folderid1(self, folderId) -> dict[str, Any]:
698
+ def get_folder_by_id(self, folderId) -> dict[str, Any]:
699
699
  """
700
- Retrieves information about a folder with the specified ID using the "GET" method at the "/v1/folders/{folderId}" endpoint.
701
-
700
+ Retrieves detailed information for a specific folder using its unique ID. This GET operation fetches folder metadata, distinguishing it from functions that delete (`v1_folders_folderid`) or update (`v1_folders_folderid2`) the same folder resource.
701
+
702
702
  Args:
703
703
  folderId (string): folderId
704
-
704
+
705
705
  Returns:
706
706
  dict[str, Any]: OK
707
-
707
+
708
708
  Tags:
709
709
  folder
710
710
  """
@@ -716,16 +716,16 @@ class CanvaApp(APIApplication):
716
716
  response.raise_for_status()
717
717
  return response.json()
718
718
 
719
- def v1_folders_folderid(self, folderId) -> Any:
719
+ def delete_folder(self, folderId) -> Any:
720
720
  """
721
- Deletes a folder with the specified ID, including all of its contents, using the DELETE method and returns a status code indicating success or failure.
722
-
721
+ Deletes a folder and all its contents using the folder's unique identifier. This function sends an HTTP DELETE request to the `/v1/folders/{folderId}` endpoint and returns a confirmation status upon successful deletion.
722
+
723
723
  Args:
724
724
  folderId (string): folderId
725
-
725
+
726
726
  Returns:
727
727
  Any: OK
728
-
728
+
729
729
  Tags:
730
730
  folder
731
731
  """
@@ -737,10 +737,10 @@ class CanvaApp(APIApplication):
737
737
  response.raise_for_status()
738
738
  return response.json()
739
739
 
740
- def v1_folders_folderid2(self, folderId, name=None) -> dict[str, Any]:
740
+ def update_folder(self, folderId, name=None) -> dict[str, Any]:
741
741
  """
742
- Updates an existing folder using the specified `folderId` and returns a status message upon successful modification.
743
-
742
+ Updates a specific folder's properties, such as its name, using its unique ID. This function sends a PATCH request to the `/v1/folders/{folderId}` endpoint to apply partial modifications and returns the updated folder information upon success.
743
+
744
744
  Args:
745
745
  folderId (string): folderId
746
746
  name (string): name
@@ -750,10 +750,10 @@ class CanvaApp(APIApplication):
750
750
  "name": "<string>"
751
751
  }
752
752
  ```
753
-
753
+
754
754
  Returns:
755
755
  dict[str, Any]: OK
756
-
756
+
757
757
  Tags:
758
758
  folder
759
759
  """
@@ -769,12 +769,12 @@ class CanvaApp(APIApplication):
769
769
  response.raise_for_status()
770
770
  return response.json()
771
771
 
772
- def v1_folders_folderid_items(
772
+ def list_folder_items(
773
773
  self, folderId, continuation=None, item_types=None
774
774
  ) -> dict[str, Any]:
775
775
  """
776
- Retrieves a paginated list of items within a specified folder, filtered by type, using continuation tokens for pagination.
777
-
776
+ Lists items within a specific folder. Supports optional filtering by item type (asset, design, folder, template) and pagination using a continuation token to navigate through large result sets.
777
+
778
778
  Args:
779
779
  folderId (string): folderId
780
780
  continuation (string): If the success response contains a continuation token, the folder contains more items
@@ -784,10 +784,10 @@ class CanvaApp(APIApplication):
784
784
  item_types (string): Filter the folder items to only return specified types. The available types are:
785
785
  `asset`, `design`, `folder`, and `template`. To filter for more than one item type,
786
786
  provide a comma-delimited list. Example: '<string>'.
787
-
787
+
788
788
  Returns:
789
789
  dict[str, Any]: OK
790
-
790
+
791
791
  Tags:
792
792
  folder
793
793
  """
@@ -803,12 +803,12 @@ class CanvaApp(APIApplication):
803
803
  response.raise_for_status()
804
804
  return response.json()
805
805
 
806
- def v1_folders_move(
806
+ def move_folder_item(
807
807
  self, from_folder_id=None, item_id=None, to_folder_id=None
808
808
  ) -> Any:
809
809
  """
810
- Moves folders to a new location using the "POST" method at the "/v1/folders/move" endpoint and returns status messages based on the operation's success or failure.
811
-
810
+ Moves an item, such as a design or another folder, from a source folder to a destination folder. It requires the unique IDs for the item, the source folder, and the target folder to perform the relocation, returning a status confirmation upon completion.
811
+
812
812
  Args:
813
813
  from_folder_id (string): from_folder_id Example: '<string>'.
814
814
  item_id (string): item_id Example: '<string>'.
@@ -821,10 +821,10 @@ class CanvaApp(APIApplication):
821
821
  "to_folder_id": "<string>"
822
822
  }
823
823
  ```
824
-
824
+
825
825
  Returns:
826
826
  Any: OK
827
-
827
+
828
828
  Tags:
829
829
  folder
830
830
  """
@@ -840,10 +840,10 @@ class CanvaApp(APIApplication):
840
840
  response.raise_for_status()
841
841
  return response.json()
842
842
 
843
- def v1_folders(self, name=None, parent_folder_id=None) -> dict[str, Any]:
843
+ def create_folder(self, name=None, parent_folder_id=None) -> dict[str, Any]:
844
844
  """
845
- Creates a new folder in the system and returns a success or error status.
846
-
845
+ Creates a new folder, optionally assigning it a name and placing it within a specified parent folder. This function is distinct from others as it uses a POST request to the base `/v1/folders` endpoint, specifically for creation.
846
+
847
847
  Args:
848
848
  name (string): name Example: '<string>'.
849
849
  parent_folder_id (string): parent_folder_id
@@ -854,10 +854,10 @@ class CanvaApp(APIApplication):
854
854
  "parent_folder_id": "<string>"
855
855
  }
856
856
  ```
857
-
857
+
858
858
  Returns:
859
859
  dict[str, Any]: OK
860
-
860
+
861
861
  Tags:
862
862
  folder
863
863
  """
@@ -872,13 +872,13 @@ class CanvaApp(APIApplication):
872
872
  response.raise_for_status()
873
873
  return response.json()
874
874
 
875
- def v1_users_me(self) -> dict[str, Any]:
875
+ def get_current_user(self) -> dict[str, Any]:
876
876
  """
877
- Retrieves information about the currently authenticated user using the GET method at the "/v1/users/me" endpoint.
878
-
877
+ Retrieves core information for the currently authenticated user, such as ID and team details. This function is distinct from `v1_users_me_profile`, which fetches more specific profile data like the user's display name and profile picture.
878
+
879
879
  Returns:
880
880
  dict[str, Any]: OK
881
-
881
+
882
882
  Tags:
883
883
  user, important
884
884
  """
@@ -888,13 +888,13 @@ class CanvaApp(APIApplication):
888
888
  response.raise_for_status()
889
889
  return response.json()
890
890
 
891
- def v1_users_me_profile(self) -> dict[str, Any]:
891
+ def get_current_user_profile(self) -> dict[str, Any]:
892
892
  """
893
- Retrieves the authenticated user's profile information.
894
-
893
+ Fetches detailed profile information for the currently authenticated user. This method is distinct from `v1_users_me`, which retrieves general user account information rather than specific profile details like display name or avatar.
894
+
895
895
  Returns:
896
896
  dict[str, Any]: OK
897
-
897
+
898
898
  Tags:
899
899
  user
900
900
  """
@@ -906,36 +906,36 @@ class CanvaApp(APIApplication):
906
906
 
907
907
  def list_tools(self):
908
908
  return [
909
- self.v1_apps_appid_jwks,
910
- self.v1_assets_assetid1,
911
- self.v1_assets_assetid3,
912
- self.v1_assets_assetid,
913
- self.v1_assets_assetid2,
914
- self.v1_assets_upload,
915
- self.v1_asset_uploads,
916
- self.v1_asset_uploads_jobid,
917
- self.v1_autofills,
918
- self.v1_autofills_jobid,
919
- self.v1_brand_templates,
920
- self.v1_brand_templates_brandtemplateid,
921
- self.v1_brand_templates_brandtemplateid_dataset,
922
- self.v1_comments,
923
- self.v1_comments_commentid_replies,
924
- self.v1_designs_designid_comments_commentid,
925
- self.v1_connect_keys,
926
- self.v1_designs,
927
- self.v1_designs1,
928
- self.v1_designs_designid,
929
- self.v1_imports,
930
- self.v1_imports_jobid,
931
- self.v1_exports,
932
- self.v1_exports_exportid,
933
- self.v1_folders_folderid1,
934
- self.v1_folders_folderid,
935
- self.v1_folders_folderid2,
936
- self.v1_folders_folderid_items,
937
- self.v1_folders_move,
938
- self.v1_folders,
939
- self.v1_users_me,
940
- self.v1_users_me_profile,
909
+ self.get_app_jwks,
910
+ self.get_asset,
911
+ self.post_update_asset,
912
+ self.delete_asset,
913
+ self.patch_asset,
914
+ self.upload_asset,
915
+ self.create_asset_upload_job,
916
+ self.get_asset_upload_job_status,
917
+ self.create_autofill_job,
918
+ self.get_autofill_job_status,
919
+ self.list_brand_templates,
920
+ self.get_brand_template_by_id,
921
+ self.get_brand_template_dataset,
922
+ self.create_comment,
923
+ self.create_comment_reply,
924
+ self.get_design_comment,
925
+ self.get_connection_keys,
926
+ self.list_designs,
927
+ self.create_design,
928
+ self.get_design,
929
+ self.create_design_import_job,
930
+ self.get_design_import_status,
931
+ self.create_design_export,
932
+ self.get_export_job_status,
933
+ self.get_folder_by_id,
934
+ self.delete_folder,
935
+ self.update_folder,
936
+ self.list_folder_items,
937
+ self.move_folder_item,
938
+ self.create_folder,
939
+ self.get_current_user,
940
+ self.get_current_user_profile,
941
941
  ]