@canva/asset

A package for Canva's Apps SDK that 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 Canva's Apps 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 Apps 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

The Apps SDK is made up of the following 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.