Importing artwork
- Last updated on May 15, 2025
- •
- 3 minutes to read
To add designs to storage, you can create or import them first. Let's learn how you can import artwork created in external tools, like Adobe Photoshop and InDesign. Such artwork may be created by professional designers and contain many design elements and document settings. In this case, you can also predefine how the design elements should behave in the editor.
The endpoint POST /api/processor/v1/designs/import
allows you to import artwork and save it to storage. The source file can be an internal Customer's Canvas state file or a graphic file in PSD or IDML format. If needed, you can generate a design preview with this endpoint.
curl -X \
POST "https://api.customerscanvashub.com/api/processor/v1/designs/import" \
-H "accept: application/json" \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: multipart/form-data" \
-F "sourceFile=@test-page.psd;type=image/psd" \
-F "previewSettings.makePreview=true" \
-F "previewSettings.width=300" \
-F "previewSettings.height=300" \
-F "previewSettings.name=thumbnail" \
-F "previewSettings.namespace=mystore"
After a design has been imported to storage, there may be situations that will not allow working with the design normally, for example, font files or data schemas may be deleted. In BackOffice, this is indicated by the red icon on the design thumbnail, and its hasProblems
property will have the true
value. To get the details about such problems, use the endpoint POST /api/processor/v1/designs/{id}/check
.
curl -X \
POST "https://api.customerscanvashub.com/api/processor/v1/designs/6551d8abef47c0b108dc75de/check" \
-H "accept: application/json" \
-H "Authorization: Bearer <TOKEN>"
A response for a design with missing fonts may look as follows:
{
"fontMissingProblems": [
{
"postscriptName": null,
"name": "Roboto_Condensed"
},
{
"postscriptName": null,
"name": "Raleway"
}
],
"dataValidationProblems": [],
"dataSchemaMissingProblem": null
}
After you have changed a source design file, you can re-import the design to storage. The endpoint POST /api/processor/v1/designs/{id}/re-import
is used when you need to replace a file without losing its metadata and ID. It will replace the design, its name, and file metadata, but the ID will remain the same. It is convenient when you are updating designs already associated with some products in your online store.
Further Reading
- Learn how to create new designs using this API.
- Explore how to create and manage preview images.
- Dive into Asset Processor API reference.