v4

latestOpenAPI 3.1.0MIT2026-08-02128224900.7 KB

Snippets

Update Snippet

Update a snippet.

patch/snippets/{id}

idstring required

identifierstring nullable

A unique, newsletter-scoped slug used to reference the snippet inside email content (e.g. {{ snippets.footer }}). Must be unique per newsletter.

namestring nullable

A human-readable name for the snippet, shown in the Buttondown UI.

contentstring nullable

The body of the snippet, substituted wherever the snippet is referenced. Interpreted according to mode.

mode'fancy' | 'naked' | 'plaintext'

An enumeration.

{
  "identifier": "footer",
  "name": "Footer",
  "content": "Thanks for reading!"
}

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

identifierstring required

A unique, newsletter-scoped slug used to reference the snippet inside email content (e.g. {{ snippets.footer }}). Must be unique per newsletter.

namestring required

A human-readable name for the snippet, shown in the Buttondown UI.

contentstring required

The body of the snippet, substituted wherever the snippet is referenced. Interpreted according to mode.

mode'fancy' | 'naked' | 'plaintext' required

An enumeration.

reference_countinteger

The number of emails that currently reference this snippet.