---
title: "POST /v1/resizes"
method: POST
path: "/v1/resizes"
tags: ["resize"]
---

# POST /v1/resizes

`POST /v1/resizes`

<Availability>

To use this API, your integration must act on behalf of a user that's on a Canva plan with premium features (such as Canva Pro).

Users on the Canva Free plan have access to a limited trial. For more information, see [Trial quotas](https://www.canva.dev/docs/connect/api-requests-responses/#trial-quotas).

</Availability>

Starts a new [asynchronous job](https://www.canva.dev/docs/connect/api-requests-responses/#asynchronous-job-endpoints)
to create a resized copy of a design. The new resized design is
added to the top level of the user's
[projects](https://www.canva.com/help/find-designs-and-folders/) (`root` folder).

To resize a design into a new design, you can either:

  - Use a preset design type.
  - Set height and width dimensions for a custom design.

Note the following behaviors and restrictions when resizing designs:
- Designs can be resized to a maximum area of 25,000,000 pixels squared.
- Resizing designs using the Connect API always creates a new design. In-place resizing is currently not available in the Connect API, but can be done in the Canva UI.
- Resizing a multi-page design results in all pages of the design being resized. Resizing a section of a design is only available in the Canva UI.
- [Canva docs](https://www.canva.com/create/documents/) and [emails](https://www.canva.com/emails/) can't be resized, and other design types can't be resized to a Canva doc or email.
- Canva Code designs can't be resized, and other design types can't be resized to a Canva Code design.

<Note>
For more information on the workflow for using asynchronous jobs,
see [API requests and responses](https://www.canva.dev/docs/connect/api-requests-responses/#asynchronous-job-endpoints).
You can check the status and get the results of resize jobs created with this API using the
[Get design resize job API](https://www.canva.dev/docs/connect/api-reference/resizes/get-design-resize-job/).
</Note>

## Request body

- CreateDesignResizeJobRequest — Body parameters for starting a resize job for a design. It must include a design ID, and one of the supported design type.
  - `design_id` string, required — The design ID.
  - `design_type` union, required — The desired design type.
    - object — Provide the common design type.
      - `type` 'preset', required
      - `name` 'doc' | 'email' | 'presentation' | 'whiteboard', required — The name of the design type.
    - object — Provide the width and height to define a custom design type. Each dimension must be between 40 and 8000 pixels, and the total area (width × height) must not exceed 25,000,000 pixels squared. For example, a design with a width of 8000 pixels can have a maximum height of 3125 pixels.
      - `type` 'custom', required
      - `width` integer, required — The width of the design, in pixels.
      - `height` integer, required — The height of the design, in pixels.

## Response `200`

OK

- CreateDesignResizeJobResponse
  - `job` DesignResizeJob, required — Details about the design resize job.
    - `id` string, required — The design resize job ID.
    - `status` 'in_progress' | 'success' | 'failed', required — Status of the design resize job.
    - `result` DesignResizeJobResult — Design has been created and saved to user's root ([projects](https://www.canva.com/help/find-designs-and-folders/)) folder.
      - `design` DesignSummary, required — Basic details about the design, such as the design's ID, title, and URL.
        - `id` string, required — The design ID.
        - `title` string — The design title.
        - `url` string — URL of the design.
        - `thumbnail` Thumbnail — A thumbnail image representing the object.
          - `width` integer, required — The width of the thumbnail image in pixels.
          - `height` integer, required — The height of the thumbnail image in pixels.
          - `url` string, required — A URL for retrieving the thumbnail image. This URL expires after 15 minutes. This URL includes a query string that's required for retrieving the thumbnail.
        - `urls` DesignLinks, required — A temporary set of URLs for viewing or editing the design.
          - `edit_url` string, required — A temporary editing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support [return navigation](https://www.canva.dev/docs/connect/return-navigation-guide/) workflows. NOTE: This is not a permanent URL, it is only valid for 30 days.
          - `view_url` string, required — A temporary viewing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support [return navigation](https://www.canva.dev/docs/connect/return-navigation-guide/) workflows. NOTE: This is not a permanent URL, it is only valid for 30 days.
        - `created_at` integer, required — When the design was created in Canva, as a Unix timestamp (in seconds since the Unix Epoch).
        - `updated_at` integer, required — When the design was last updated in Canva, as a Unix timestamp (in seconds since the Unix Epoch).
        - `page_count` integer — The total number of pages in the design. Some design types don't have pages (for example, Canva docs).
      - `trial_information` TrialInformation — WARNING: Trials and trial information are a [preview feature](https://www.canva.dev/docs/connect/#preview-apis). There might be unannounced breaking changes to this feature which won't produce a new API version. Trial information for non-qualifying users. Non-qualifying users have a limited number of resize uses. Once the trial is exhausted, users must upgrade to a Canva plan with premium features (such as Canva Pro) to continue using the Resize API.
        - `uses_remaining` integer, required — The number of uses remaining in the free trial.
        - `upgrade_url` string, required — The URL for a user to upgrade their Canva account.
    - `error` DesignResizeError — If the design resize job fails, this object provides details about the error.
      - `code` 'thumbnail_generation_error' | 'design_resize_error' | 'create_design_error' | 'trial_quota_exceeded', required
      - `message` string, required — A human-readable description of what went wrong.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `default` — Error Response

---

[API](https://skmtc.net/canva/apis/canva-connect-api.md) · [All operations](https://skmtc.net/canva/apis/canva-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/canva/canva-connect-api/versions/499c392c7720/schema)