export

<Warning>

This API is currently provided as a preview. Be aware of the following:

  • There might be unannounced breaking changes.
  • Any breaking changes to preview APIs won't produce a new API version.
  • Public integrations that use preview APIs will not pass the review process, and can't be made available to all Canva users.
</Warning>

AVAILABILITY: This API is only available to Print Partners.

Starts a new asynchronous job to export a Print Partner file from Canva. Once the exported file is generated, you can download it using the URL(s) provided. The download URLs are only valid for 24 hours. The request requires the design ID and exports a file as a print-quality PDF.

<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 export jobs created with this API using the [Get design export job API](https://www.canva.dev/docs/connect/api-reference/exports/get-design-export-job/). </Note>
post/v1/print-partner/exports

Request body

design_idstring required

The design ID.

pagesinteger[]

To specify which pages to export in a multi-page design, provide the page numbers as an array. The first page in a design is page 1. If pages isn't specified, all the pages are exported.

Example request

{
  "design_id": "DAVZr1z5464",
  "format": {
    "type": "pdf"
  },
  "pages": [
    2,
    3,
    4
  ],
  "dimensions": {
    "width": 200,
    "height": 300,
    "units": "px"
  }
}

Response

OK

Example response

{
  "job": {
    "id": "e08861ae-3b29-45db-8dc1-1fe0bf7f1cc8",
    "urls": [
      "https://export-download.canva.com/..."
    ]
  }
}

Changes

Changed in 2 of the 8 revisions of this API.152

  • f32aa6ee029d52See the full diff
    • added the new design_generation_rejected enum value to the code response property for the response status 400

      response-property-enum-value-added

    • added the new design_generation_rejected enum value to the code response property for the response status 403

      response-property-enum-value-added

    • added the new design_generation_rejected enum value to the code response property for the response status 404

      response-property-enum-value-added

    • added the new design_generation_rejected enum value to the code response property for the response status 429

      response-property-enum-value-added

    • added the new design_generation_rejected enum value to the code response property for the response status default

      response-property-enum-value-added

    • added jpg png discriminator mapping keys to the format request property

      request-property-discriminator-mapping-added

    • added PrintPartnerJpgExportFormat PrintPartnerPngExportFormat to the format request property oneOf list

      request-property-one-of-added

    • added the new domain_restricted enum value to the code response property for the response status 400

      response-property-enum-value-added

    • added the new domain_restricted enum value to the code response property for the response status 403

      response-property-enum-value-added

    • added the new domain_restricted enum value to the code response property for the response status 404

      response-property-enum-value-added

    • added the new domain_restricted enum value to the code response property for the response status 429

      response-property-enum-value-added

    • added the new domain_restricted enum value to the code response property for the response status default

      response-property-enum-value-added

    • added the new user_already_member enum value to the code response property for the response status 400

      response-property-enum-value-added

    • added the new user_already_member enum value to the code response property for the response status 403

      response-property-enum-value-added

    • added the new user_already_member enum value to the code response property for the response status 404

      response-property-enum-value-added

    • added the new user_already_member enum value to the code response property for the response status 429

      response-property-enum-value-added

    • added the new user_already_member enum value to the code response property for the response status default

      response-property-enum-value-added