get canvas
Read a canvas: its size, slides, and every layer’s id, name, kind and box in slide pixels, the ids every operation names. A read stops at about 60,000 characters of layers, whole slides first, says so in cut_short, and next_cursor reads on; slide, layer_ids or types narrow it. response_format detailed returns layers as stored, for matching a look or rewriting text runs. local_only marks a picture only on someone’s computer, which the cloud cannot draw until it syncs. With no canvas_id it lists the workspace’s canvases, newest edit first, or with find_text those whose text holds the words. history adds the versions undo takes; destinations the named sizes. Free.
Authorizations
An API key (es_live_…) from Settings, under API keys, or an OAuth access token.
Headers
Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.
The workspace this one call acts in, when it is not the key's own.
Body
Leave it out to list the workspace's canvases instead of reading one.
With no canvas_id: only the canvases whose text layers hold these words, whatever the case, each with the layers that do.
2 - 200One slide, by id or by its place from 0. Default: every slide.
Only these layers, wherever they sit, groups walked into.
200Only these kinds of layer; "text" alone is how a translation reads a canvas.
image, text, shape, icon, chart, group, adjustment concise (default): each layer's id, name, kind, box and key facts. detailed: the stored layers whole. shape: the canvas's size and slides without layers.
concise, detailed, shape Include this many saved versions, newest first.
1 <= x <= 50Include the named sizes (Instagram post, YouTube thumbnail, A4…) with their ids and pixels; works with or without canvas_id.
Listing only: canvases per page. Default 50.
1 <= x <= 100next_cursor from the answer before, with the other fields the same: the next page of the list, or the rest of a canvas a read cut short.

