Skip to main content
POST
templates.create(pathOrDocument): the next version of the document's name

Authorizations

Authorization
string
header
required

An API key, or a session token on its own session

Query Parameters

dryRun
boolean

Check the document and answer the version a create would return, storing nothing

Body

A template as one document, in its JSON spelling.

apiVersion
enum<string>
required
Available options:
paddock.build/v1
kind
enum<string>
required
Available options:
Template
metadata
object
required
spec
object
required

Response

The document equals the name's latest version, or the answer of a dry run

name
string
required
Pattern: ^[a-z0-9-]{1,64}$
version
integer
required
Required range: x >= 1
harness
enum<string>
required
Available options:
claude-code,
codex,
pi
model
string
required
labels
object
required

The customer's own string keys and values; never case-converted.

digest
string
required
createdAt
string<date-time>
required

RFC 3339 in UTC with milliseconds.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\.[0-9]{3}Z$