> ## Documentation Index
> Fetch the complete documentation index at: https://www.canva.dev/docs/apps/llms.txt
> Use this file to discover all available pages before exploring further.

# getTemporaryUrl

API reference for the getTemporaryUrl method.

Retrieves a temporary URL that points to an asset in Canva's backend.

## Usage

### Get the URL of an uploaded image asset

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

const placeholderImageRef = "PLACEHOLDER_IMAGE_REF" as ImageRef;

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

### Get the URL of an uploaded video asset

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

const placeholderVideoRef = "PLACEHOLDER_VIDEO_REF" as VideoRef;

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

### Download and re-upload as a derived asset

```typescript
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"
});
```

## Parameters

<Prop.List>
  <Prop name="options" required type="GetTemporaryUrlOptions" sourceLineNumbers={[455]}>
    Options for retrieving a temporary URL that points to an asset in Canva's backend.

    <Tabs>
      <Tab name="Images">
        Options for retrieving a temporary URL that points to an image asset in Canva's backend.

        <Prop.List>
          <Prop name="type" required type="string" sourceLineNumbers={[466]}>
            The type of asset.

            The only valid value is `"image"`.
          </Prop>

          <Prop name="ref" required type="ImageRef" sourceLineNumbers={[470]}>
            A unique identifier that points to an image asset in Canva's backend.
          </Prop>
        </Prop.List>
      </Tab>

      <Tab name="Videos">
        Options for retrieving a temporary URL that points to a video asset in Canva's backend.

        <Prop.List>
          <Prop name="type" required type="string" sourceLineNumbers={[481]}>
            The type of asset.

            The only valid value is `"video"`.
          </Prop>

          <Prop name="ref" required type="VideoRef" sourceLineNumbers={[485]}>
            A unique identifier that points to a video asset in Canva's backend.
          </Prop>
        </Prop.List>
      </Tab>
    </Tabs>
  </Prop>
</Prop.List>

## Returns

The result of retrieving a temporary URL of an asset in Canva's backend. This is a `Promise` that resolves with the following object:

<Tabs>
  <Tab name="Images">
    The result of retrieving a temporary URL of an image asset in Canva's backend.

    <Prop.List>
      <Prop name="type" required type="string" sourceLineNumbers={[932]}>
        The type of asset.

        The only valid value is `"image"`.
      </Prop>

      <Prop name="ref" required type="ImageRef" sourceLineNumbers={[936]}>
        A unique identifier that points to an image asset in Canva's backend.
      </Prop>

      <Prop name="url" required type="string" sourceLineNumbers={[940]}>
        A temporary URL for downloading the asset.
      </Prop>
    </Prop.List>
  </Tab>

  <Tab name="Videos">
    The result of retrieving a temporary URL of a video asset in Canva's backend.

    <Prop.List>
      <Prop name="type" required type="string" sourceLineNumbers={[951]}>
        The type of asset.

        The only valid value is `"video"`.
      </Prop>

      <Prop name="ref" required type="VideoRef" sourceLineNumbers={[955]}>
        A unique identifier that points to a video asset in Canva's backend.
      </Prop>

      <Prop name="url" required type="string" sourceLineNumbers={[959]}>
        A temporary URL for downloading the asset.
      </Prop>
    </Prop.List>
  </Tab>
</Tabs>

## Permissions

To use this method, the `canva:asset:private:read` permission must be enabled for the app. To learn more, see [Permissions](https://www.canva.dev/docs/apps/configuring-intents-permissions/).

## Rate limit

This method has a rate limit of 30 requests every 10 seconds.