POST /v1/asset-uploads — canva-connect-api

v3

asset

Starts a new asynchronous job to upload an asset to the user's content library. Supported file types for assets are listed in the Assets API overview.

The request format for this endpoint is an application/octet-stream body of bytes. Attach information about the upload using an Asset-Upload-Metadata header.

<Note>

For more information on the workflow for using asynchronous jobs, see API requests and responses. You can check the status and get the results of asset upload jobs created with this API using the Get asset upload job API.

</Note>

post/v1/asset-uploads

Headers

Response

Example response

{
  "job": {
    "id": "e08861ae-3b29-45db-8dc1-1fe0bf7f1cc8",
    "status": "success",
    "asset": {
      "id": "Msd59349ff",
      "type": "image",
      "name": "My Awesome Upload",
      "tags": [
        "image",
        "holiday",
        "best day ever"
      ],
      "owner": {
        "user_id": "oU123456AbCdE",
        "team_id": "oB123456AbCdE"
      },
      "created_at": 1377396000,
      "updated_at": 1692928800,
      "thumbnail": {
        "width": 595,
        "height": 335,
        "url": "https://document-export.canva.com/Vczz9/zF9vzVtdADc/2/thumbnail/0001.png?<query-string>"
      }
    }
  }
}