Promote the canary
POST/templates/:id/channels/:name/promote
The canary version becomes the channel's main version and the canary is cleared; the old main version becomes previous_version. A channel without a canary answers 400 invalid_request. The schema check of publishing applies (409 schema_breaking_change unless allow_breaking). Needs template:write.
Request
Responses
- 200
- 400
- 404
- 409
- 422
- default
Promoted.
Error (RFC 9457 problem details).
Not found for the key: not_found, or template_not_found for a template or version. Templates, renders, files and webhooks are looked up in the workspace of the key, shared partials and workspaces in its organisation.
Error (RFC 9457 problem details).
The request was understood but cannot be rendered: data that does not fit the schema (data_validation_error), a template error (template_syntax_error, template_runtime_error, with location), a page that does not load (navigation_failed), a page or size limit of the plan (page_limit_exceeded, output_too_large), a source a PDF step cannot use (source_not_found, source_invalid, source_encrypted), or an e-invoice or PDF/UA failure.
Error (RFC 9457 problem details).