@canva/asset

A Canva Developers SDK package for building apps inside Canva. Provides methods for working with assets.

Table of contents

• Introduction
• Installation
• Usage
• API reference
• Related packages
• Contributing
• License

Introduction

@canva/asset is an npm package for building apps inside Canva with the Canva Developers SDK. It provides methods for working with assets, such as image and video files. For example, the package exports a upload method that uploads assets to the user's media library.

Note: To get up and running with the Canva Developers SDK, check out the quick start guide.

Installation

npm install @canva/asset

Usage

1. Import a method or namespace from the @canva/asset package:

   import { upload } from '@canva/asset';
   

2. Call a method, passing in the required arguments (if any):

   await upload({
     type: 'IMAGE',
     id: 'uniqueIdGoesHere',
     mimeType: 'image/jpeg',
     url: 'https://www.canva.dev/example-assets/image-import/image.jpg',
     thumbnailUrl: 'https://www.canva.dev/example-assets/image-import/thumbnail.jpg',
   });
   

API reference

• getTemporaryUrl
• upload

Related packages

Apps inside Canva are built with the following Canva Developers SDK packages:

• @canva/app-ui-kit - React-based component library for creating apps that mimic the look and feel of Canva.
• @canva/asset - Provides methods for working with assets, such as image and video files.
• @canva/design - Provides methods for interacting with the user's design, such as creating elements.
• @canva/error - Provides a CanvaError class for handling errors.
• @canva/platform - Provides utility methods, such as a method for opening external links.
• @canva/user - Provides methods for accessing user data and authenticating users.

Contributing

We're actively developing this package but are not currently accepting third-party contributions. If you'd like to request any changes or additions to the package, submit a feature request via the Canva Developers Community.

License

See the LICENSE.md file.