---
title: "POST /v1/print-partner/exports"
method: POST
path: "/v1/print-partner/exports"
tags: ["export"]
---

# POST /v1/print-partner/exports

`POST /v1/print-partner/exports`

<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](https://www.canva.dev/docs/connect/versions/).
- 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](https://www.canva.dev/docs/connect/api-requests-responses/#asynchronous-job-endpoints) 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>

## Request body

- CreatePrintPartnerDesignExportJobRequest — Body parameters for starting a Print Partner export job for a design. It must include a design ID. Canva Docs are not supported for export.
  - `design_id` string, required — The design ID.
  - `dimensions` PrintPartnerExportDimensions — Dimensions of the export in the specified units. The design dimensions must be within a scale factor of 0.3 and 3 of the requested export dimensions.
    - `width` number, double — The width of the exported image. Note the following behavior: - If no height or width is specified, the image is exported using the dimensions of the design. - If only one of height or width is specified, then the image is scaled to match that dimension, respecting the design's aspect ratio. - If both the height and width are specified, but the values don't match the design's aspect ratio, the export defaults to the larger dimension.
    - `height` number, double — The height of the exported image. Note the following behavior: - If no height or width is specified, the image is exported using the dimensions of the design. - If only one of height or width is specified, then the image is scaled to match that dimension, respecting the design's aspect ratio. - If both the height and width are specified, but the values don't match the design's aspect ratio, the export defaults to the larger dimension.
    - `units` 'px' | 'in' | 'cm' | 'mm' — The units of the dimensions. If no units are specified, pixels are used.
  - `format` PrintPartnerExportFormat, required — Export the design as a Print-quality PDF.
    - `type` 'pdf', required
    - `bleed` integer — The size of the bleed that should be added to the design. The units of the bleed must be microns. This should match the bleed value used when creating the design with the [Create print partner design API](https://www.canva.dev/docs/connect/api-reference/print-partner/create-print-partner-design/). Use 0 for no bleed. If bleed is not specified, a default of 3000 microns is used.
    - `crop_marks` boolean — Whether crop marks should be added to the image.
    - `cmyk` boolean — Whether the PDF color space should be converted to CMYK.
    - `pdfx` boolean — Whether the PDF standard should be updated to PDF/X, a printer friendly standard.
  - `pages` integer[] — 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.

## Response `200`

OK

- CreatePrintPartnerDesignExportJobResponse
  - `job` ExportJob, required — The status of the export job.
    - `id` string, required — The export job ID.
    - `status` 'failed' | 'in_progress' | 'success', required — The export status of the job. A newly created job will be `in_progress` and will eventually become `success` or `failed`.
    - `urls` string[] — Download URL(s) for the completed export job. These URLs expire after 24 hours. Depending on the design type and export format, there is a download URL for each page in the design. The list is sorted by page order.
    - `error` ExportError — If the export fails, this object provides details about the error.
      - `code` 'license_required' | 'approval_required' | 'internal_failure', required — If the export failed, this specifies the reason why it failed.
      - `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)