canva

1# Canva
2 
3## Purpose
4Read and manage Canva designs through the Canva Connect API: list designs and folders, inspect a design, create designs, upload assets, and export designs. Exports are async jobs: submit with `export`, then poll with `export-status` until the job succeeds.
5 
6## Tooling
7All commands go through `bin/canva.py`:
8 
9```bash
10bin/canva.py auth                                        # verify the connection (prints the Canva user)
11bin/canva.py designs --query "pitch deck"                # list designs, optional search
12bin/canva.py design --id DESIGN_ID                      # get one design's details
13bin/canva.py folders                                     # list folders
14bin/canva.py folder-items --id FOLDER_ID                 # list items in a folder
15bin/canva.py assets                                      # list uploaded assets
16bin/canva.py create --data '{"design_type":{"type":"preset","name":"presentation"}}'
17                                                         # create a design (raw JSON body, per Canva docs)
18bin/canva.py upload-asset --file ./logo.png              # upload a local file as an asset
19bin/canva.py upload-asset --url https://example.com/a.png  # import an asset from a URL
20bin/canva.py export --design-id DESIGN_ID --format png   # submit an async export job (png, jpg, pdf, mp4, ...)
21bin/canva.py export-status --id EXPORT_ID                # poll the export job; prints download URLs when done
22```
23 
24## Auth
25…