Save page-builder custom template

POST 
/openapi/2026-01/themes/page-builder/custom-templates

Save a custom card template based on an existing template; action decides how it is saved. All three actions produce a new template id, and update takes the original template down.

Request

application/json

Body

Bodyrequired

actionstringrequired
Action. All three create a new template; they differ in whether it is listed:
• save_as: A new copy, listed
• update: A new listed version; the template given by template_id is taken down
• save: Saved but not shown in the template list
template_idstringrequired

Source template id for save_as / the template to version up for update

titleobject

Template title (i18n map). Optional; defaults to the source template's title

categorystring

First-level category. Optional; defaults to source

second_categorystring

Second-level category. Optional; defaults to source

imagestring

Preview image filename. Optional; defaults to source

originstring

Origin type: custom, global. Optional; defaults to source

Example

json

{
  "action": "string",
  "template_id": "string",
  "title": {},
  "category": "string",
  "second_category": "string",
  "image": "string",
  "origin": "string"
}

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

idstring

Saved template id. Always a new id — update also creates a new template and hides the one passed in template_id

series_idstring

Series id

show_templatesint32

Number of show templates

Example

json

{
  "code": "string",
  "message": "string",
  "data": {
    "id": "string",
    "series_id": "string",
    "show_templates": 0
  }
}