Documentation
Sign inGet started

bird email templates update

Usage

Exemplo de código
bird email templates update <template-ref> [flags]

Description

Update an email template
Change a template's metadata and draft settings, such as its name or default language; only the fields sent change. Content is not edited here; a language is saved on the draft version. The request must include the draft revision last read; a concurrent change returns a conflict.
Build the request from flags, a JSON EmailTemplateUpdate body via --body-file ("-" reads stdin), or both — a flag overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

Examples

Exemplo de código
# print the body shape (no credentials needed)
bird email templates update --example

# the body it prints:
Exemplo de código
{
  "default_language": "pt-BR",
  "on_missing_language": "fallback",
  "revision": 3
}

Options

Request

NameDescription
--body-fileRead the JSON request body from this file; "-" reads stdin
--examplePrint a complete example request body, then exit
--dry-runPrint the resolved request without sending it, then exit
--idempotency-keyDeduplication key; a retry with the same key won't act twice

Options

NameDescription
--revision <n>The draft revision you last read (from the template's revision field). A stale value returns a conflict so you can reload and retry.
--nameNew display name. Free text; the slug is fixed at creation and cannot be changed, so whatever references the template keeps working across a rename.
--descriptionNew description of the template's purpose. Send null to clear it.
--default-languageNew default language for the draft. Must be one of the languages the draft already carries, so add the language first if it is not there yet.
--on-missing-languageHow a send behaves when it asks for a language this template does not carry. Possible values: fallback, fail.
--language-source-requiredWhether a send has to name a language. Turning it on rejects a send that names none instead of serving the default language, and makes the template unusable for a broadcast, which has no way to name one.
--response-schemaPrint the fields this command returns, then exit
NameDescription
bird email templates createCreate an email template and its first editable draft
bird email templates deleteDelete an email template
bird email templates duplicateDuplicate an email template
bird email templates getGet an email template
bird email templates listList email templates
bird email templates previewRender a template with sample values