Skip to main content
POST
Create a template

Authorizations

Authorization
string
header
required

Project API key (ck_live_… or ck_test_…) presented as a bearer token. For embed partner endpoints this is the partner secret key, which is the same credential type.

Body

application/json

Create/upsert body. manifest and pageConfig are validated against the shared schema package; layout is an optional explicit CanvasDocument.

name
string
required
Required string length: 1 - 120
manifest
object
required
slug
string

Optional on create (auto-derived from name); ignored by PUT (URL is canonical).

Maximum string length: 120
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
description
string
Maximum string length: 280
layout
object

Optional CanvasDocument contentJson; synthesized from the manifest when omitted.

pageConfig
object

Response

Template created and version 1 published.

id
string<uuid>
required
slug
string
required
currentVersionNumber
integer
required
manifest
object
required