Skip to main content
POST
Create a palette

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 palette.

title
string
required

The palette's name.

Required string length: 1 - 200
colors
object[]
required

The colours, in order.

Maximum array length: 500

Response

Created.

A colour palette.

object
string
required
Allowed value: "palette"
id
string
required
title
string | null
required
colors
object[]
required
builtIn
boolean
required

Provided by Print.App: it cannot be changed, only hidden by deleting it.

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