Skip to main content
POST
Create an imposition rule

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

Makes a retry safe: a second request with the same key and the same body gets the first response back (for 24 hours) instead of creating the resource again. Use a new key, such as a UUID, for every new request.

Required string length: 1 - 255

Body

application/json

A new imposition rule: its sections, or basedOn to copy another rule's unit and sections (what you send replaces what is copied). Give it to designs with impositionRuleId on PATCH /v2/designs/{id}.

title
string
required

The rule's name.

Required string length: 1 - 200
description
string

What it is for.

Maximum string length: 500
basedOn
string

A rule to start from, such as a built-in one.

Required string length: 1 - 120
unit
enum<string>

The unit of every sheet size and offset. Default mm.

Available options:
mm,
cm,
in,
pt
sections
object[]

Applied in order. Pages no section takes print as they are.

Required array length: 1 - 20 elements

Response

Created.

How the print PDF of a design puts its pages on sheets: joined into spreads (a book cover, calendar pairs) or placed on a fixed sheet. Designs use one with impositionRuleId; a customer's project follows its design's.

object
string
required
Allowed value: "imposition_rule"
id
string
required

The rule id: imposition_…, or a built-in _imposition_….

title
string | null
required
description
string | null
required

What it is for.

builtIn
boolean
required

One of Print.App's rules: it can be used and copied (basedOn), not changed.

unit
enum<string>
required

The unit of every sheet size and offset.

Available options:
mm,
cm,
in,
pt
sections
object[]
required

Applied in order. Pages no section takes print as they are.

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