Skip to main content
PATCH
Update a PDF profile

Authorizations

Authorization
string
header
required

A secret key from Print.App admin → Domains → Secret keys, sent as Authorization: Bearer sk_…. Server-side only.

Path Parameters

id
string
required

The profile id.

Body

application/json

The fields to change.

title
string

The profile's name.

Required string length: 1 - 200
description
string
Maximum string length: 500
compatibility
enum<string>

The PDF version or standard. Default 1.7.

Available options:
1.4,
1.5,
1.6,
1.7,
2.0,
PDF/A-3a,
PDF/UA-1,
PDF/X-5n
colorProfile
enum<string> | null

Convert colours to this output profile (cmyk-coated-fogra39 for European coated stock, cmyk-us-web-coated-swop for US, sRGB for digital and photo printers). null: no conversion.

Available options:
sRGB,
cmyk,
cmyk-coated-fogra27,
cmyk-coated-fogra39,
cmyk-coated-gracol2006,
cmyk-eci-iso-coated-v2-300,
cmyk-eci-iso-coated-v2-eci,
cmyk-eci-iso-uncoated-yellowish,
cmyk-eci-pso-coated-300-npscreen-iso12647,
cmyk-eci-pso-coated-npscreen-iso12647,
cmyk-eci-pso-lwc-improved,
cmyk-eci-pso-lwc-standard,
cmyk-eci-pso-mfc-paper,
cmyk-eci-pso-snp-paper,
cmyk-eci-pso-uncoated-iso12647,
cmyk-eci-pso-uncoated-npscreen-iso12647,
cmyk-eci-sc-paper,
cmyk-japan-200-newspaper,
cmyk-japan-2001-coated,
cmyk-japan-2001-uncoated,
cmyk-japan-2003-web-coated,
cmyk-japan-web-coated,
cmyk-uncoated-fogra29,
cmyk-us-web-coated-swop,
cmyk-us-web-uncoated,
cmyk-web-coated-fogra28,
cmyk-web-coated-swop-2006-g3,
cmyk-web-coated-swop-2006-g5,
null
embedIccProfile
boolean

Embed the output profile in the PDF.

renderSpotColors
boolean

Keep spot colours (foils, Pantone) as separate inks.

renderInvisibleLayers
boolean

Include hidden layers (such as a white underbase).

renderMarks
boolean

Add crop and bleed marks.

includeScreenshot
boolean

Add a page with a flat preview of the design.

renderDieline
boolean

Draw the cut line of die-cut pages (stickers, labels) as a named spot stroke.

dielineSpot
string

The cut line's spot colour name, as the cutter expects it. Default CutContour.

Required string length: 1 - 100
dielineWidth
number

The cut line's width in points. Default 0.25.

Required range: x <= 10
downsampleImages
boolean

Reduce images above downsampleResolution, for smaller files.

downsampleResolution
integer

Pixels per inch images are reduced to. Default 300.

Required range: 72 <= x <= 600
jpegQuality
integer

JPEG quality of reduced images. Default 91.

Required range: 10 <= x <= 100
convertImageColorSpace
boolean

Convert images to the output profile too (needs colorProfile).

embedIccProfileInImages
boolean
honorImageIccProfile
boolean

Use each image's own colour profile when converting it.

interpolateImages
boolean

Smooth images when they are enlarged.

imageRenderingIntent
enum<string>

How out-of-gamut image colours are mapped. Default Auto.

Available options:
Auto,
AbsoluteColorimetric,
RelativeColorimetric,
Saturation,
Perceptual
embedFonts
boolean

Embed fonts, so the printer needs none installed.

subsetFonts
boolean

Embed only the characters used.

flattenFonts
boolean

Turn text into outlines (no fonts in the PDF at all).

requirePassword
boolean

The PDF opens only with password.

password
string | null

The password the PDF opens with; null removes it.

Required string length: 1 - 100

Response

OK.

The settings the print PDF of a design is made with.

object
string
required
Allowed value: "pdf_profile"
id
string
required
title
string | null
required
description
string | null
required
builtIn
boolean
required

Provided by Print.App: it cannot be changed; make your own with basedOn.

compatibility
string
required

The PDF version or standard. Default 1.7.

colorProfile
string | null
required

Convert colours to this output profile (cmyk-coated-fogra39 for European coated stock, cmyk-us-web-coated-swop for US, sRGB for digital and photo printers). null: no conversion.

embedIccProfile
boolean
required

Embed the output profile in the PDF.

renderSpotColors
boolean
required

Keep spot colours (foils, Pantone) as separate inks.

renderInvisibleLayers
boolean
required

Include hidden layers (such as a white underbase).

renderMarks
boolean
required

Add crop and bleed marks.

includeScreenshot
boolean
required

Add a page with a flat preview of the design.

renderDieline
boolean
required

Draw the cut line of die-cut pages (stickers, labels) as a named spot stroke.

dielineSpot
string
required

The cut line's spot colour name, as the cutter expects it. Default CutContour.

dielineWidth
number
required

The cut line's width in points. Default 0.25.

downsampleImages
boolean
required

Reduce images above downsampleResolution, for smaller files.

downsampleResolution
number
required

Pixels per inch images are reduced to. Default 300.

jpegQuality
number
required

JPEG quality of reduced images. Default 91.

convertImageColorSpace
boolean
required

Convert images to the output profile too (needs colorProfile).

embedIccProfileInImages
boolean
required
honorImageIccProfile
boolean
required

Use each image's own colour profile when converting it.

interpolateImages
boolean
required

Smooth images when they are enlarged.

imageRenderingIntent
string
required

How out-of-gamut image colours are mapped. Default Auto.

embedFonts
boolean
required

Embed fonts, so the printer needs none installed.

subsetFonts
boolean
required

Embed only the characters used.

flattenFonts
boolean
required

Turn text into outlines (no fonts in the PDF at all).

requirePassword
boolean
required

The PDF opens only with password.

hasPassword
boolean
required

A password is set (it is never shown).

created
string<date-time> | null
required
modified
string<date-time> | null
required