getTemporaryUrl

import { type ImageRef, getTemporaryUrl } from "@canva/asset";

const placeholderImageRef = "PLACEHOLDER_IMAGE_REF" as ImageRef;

const result = await getTemporaryUrl({
  type: "image",
  ref: placeholderImageRef
});

import { type VideoRef, getTemporaryUrl } from "@canva/asset";

const placeholderVideoRef = "PLACEHOLDER_VIDEO_REF" as VideoRef;

const result = await getTemporaryUrl({
  type: "video",
  ref: placeholderVideoRef
});

import { type ImageRef, getTemporaryUrl, upload } from "@canva/asset";

const originalImageRef = "PLACEHOLDER_IMAGE_REF" as ImageRef;

// Get the temporary URL for the original image
const { url } = await getTemporaryUrl({
  type: "image",
  ref: originalImageRef
});

// Process the image (e.g., apply effects)
const processedImageUrl = await processImage(url);

// Upload the processed image with parentRef pointing to the original
await upload({
  type: "image",
  parentRef: originalImageRef,
  url: processedImageUrl,
  mimeType: "image/jpeg",
  thumbnailUrl: processedImageUrl,
  // If you used AI to process the image, set this to "app_generated"
  aiDisclosure: "none"
});