Save a new version of a template

Saves the sources as the template’s next version (the latest version’s number plus one), checked as at creation. Every save is a version. The name and the kind stay. Needs scope write.

Parameters

Name	In	Type	Description
`project_id`required	path	string · uuid	The project’s id
`template_id`required	path	string · uuid	The template’s id

Request body

application/json · required

UpdateTemplateRequest object
html_bodystringrequired

The HTML body, as at creation.
subjectstring | null

The subject, as at creation.
text_bodystring | null

The text body; null or left out: made from the HTML.

Responses

200

The new version

Template object · all fields required
created_atstring · date-time

When this version was saved.
engineTemplateEngine

The template engine.
- minijinja
html_bodystring
idstring · uuid

The template’s id, the same in every version.

example 01900000-0000-7000-8000-000000000001
kindTemplateKind

What a template is.
- message
- partial
namestring

example Welcome
project_idstring · uuid
subjectstring | null

null for a partial.
text_bodystring | null

null: the text is made from the HTML when the message is sent.
versioninteger · int32

From 1, one more at each save.

≥ 1 · example 2

400

Not JSON (invalid_json)

Problem (application/problem+json)

401

No valid key

Problem (application/problem+json)

403

A project key without scope write (forbidden)

Problem (application/problem+json)

404

No such project or template in it, or another project’s (not_found)

Problem (application/problem+json)

409

The project is deleted, or another save took the version number at the same moment (conflict)

Problem (application/problem+json)

413

Over 10 MB (body_too_large)

Problem (application/problem+json)

415

Not application/json (unsupported_media_type)

Problem (application/problem+json)

422

Invalid fields or sources, every one in errors (validation_failed), as at creation

Problem (application/problem+json)

429

The key is over its rate limit, api.rate_limit_per_minute requests a minute on this node (rate_limited)

Header	Type	Description
`Retry-After`	integer	Seconds until the key’s next request passes; rounded up.

Problem (application/problem+json)

504

Postwind’s storage did not answer within its time limit (storage_timeout). A change the request makes may still take effect: check before repeating it. A repeat with the same Idempotency-Key never runs it twice: it is 409 idempotency_key_in_progress until the key’s 24 h end

Problem (application/problem+json)