Canvas Ingestion
Ingestion turns an uploaded file into an artifact on a Canvas. It is the only way external content enters a Canvas.
Supported Formats
Six formats are supported. No other file type can be ingested. PDF, Word, email, archive, audio, and video formats are not supported.
Format | Media types | Extensions |
|---|---|---|
text |
|
|
csv |
|
|
xlsx |
|
|
json |
|
|
html |
|
|
image |
|
|
An unsupported media type returns BAD_REQUEST with the message Unsupported ingestion media type.
Upload
Upload one file per request, up to 20 MiB (20,971,520 bytes).
Upload is subject to the same access rules as Canvas. See Canvas Access. Requests that fail these checks return 404 Not found.
After a successful upload:
- The Canvas gains an
artifactnode labelled with the file name. The node has no data. - The node is placed at the default position, x 80, y 120.
- A Canvas version is saved with the summary
Uploaded <filename>.