v3

latestOpenAPI 3.0.0©2023 All Rights Reserved2026-08-0659315450.0 KB
resize

<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.

</Availability>

Starts a new asynchronous job to create a resized copy of a design. The new resized design is added to the top level of the user's projects (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 and 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>
post/v1/resizes

Request body

design_idstring required

The design ID.

Example request

{
  "design_type": {
    "width": 320,
    "height": 200
  }
}

Response

OK

Example response

{
  "job": {
    "id": "bbd8dfcd-ead1-4871-81d5-962bfec82274",
    "status": "success",
    "result": {
      "design": {
        "id": "DAFVztcvd9z",
        "title": "My summer holiday",
        "url": "https://www.canva.com/design/DAFVztcvd9z/edit",
        "thumbnail": {
          "width": 595,
          "height": 335,
          "url": "https://document-export.canva.com/Vczz9/zF9vzVtdADc/2/thumbnail/0001.png?<query-string>"
        },
        "urls": {
          "edit_url": "https://www.canva.com/api/design/eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIiwiZXhwaXJ5IjoxNzQyMDk5NDAzMDc5fQ..GKLx2hrJa3wSSDKQ.hk3HA59qJyxehR-ejzt2DThBW0cbRdMBz7Fb5uCpwD-4o485pCf4kcXt_ypUYX0qMHVeZ131YvfwGPIhbk-C245D8c12IIJSDbZUZTS7WiCOJZQ.sNz3mPSQxsETBvl_-upMYA/edit",
          "view_url": "https://www.canva.com/api/design/eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIiwiZXhwaXJ5IjoxNzQyMDk5NDAzMDc5fQ..GKLx2hrJa3wSSDKQ.hk3HA59qJyxehR-ejzt2DThBW0cbRdMBz7Fb5uCpwD-4o485pCf4kcXt_ypUYX0qMHVeZ131YvfwGPIhbk-C245D8c12IIJSDbZUZTS7WiCOJZQ.sNz3mPSQxsETBvl_-upMYA/view"
        },
        "created_at": 1377396000,
        "updated_at": 1692928800,
        "page_count": 3
      },
      "trial_information": {
        "upgrade_url": "https://www.canva.com/?tailoringUpsellDialog=GENERIC_C4W"
      }
    }
  }
}