API reference for the "/publish/resources/upload" endpoint.
The purpose of the request is to upload the user's design to the destination platform.
The body of the request includes an array of assets. If a user publishes their design as a JPG or PNG, each page of the design is a separate asset. If the user publishes their design as a PDF or PPTX, the entire design is a single asset.
Each asset has a URL, which the extension must use to download the asset and upload it to the destination platform.
- Extensions must respond to this request within 8 seconds.
- When sending this request, Canva replaces
<base_url>with the extension's Base URL. You can configure the Base URL via the Developer Portal.
- If a user publishes a design that contains embedded media, such as a YouTube video or Instagram photo, Canva temporarily caches that media. If the user re-publishes their design, any changes to the underlying media (for example, a new thumbnail for a YouTube video) may not be reflected in the published design. The cache duration is approximately 24 hours.
The response an extension provides when it successfully uploads the published assets to the destination platform.
A thumbnail image.