Update a snippet

curl --request PUT \
  --url https://api.kit.com/v4/snippets/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-Kit-Api-Key: <api-key>' \
  --data '
{
  "name": "Dog Fact of the Day"
}
'

{
  "snippet": {
    "id": 59,
    "name": "Dog Fact of the Day",
    "snippet_type": "inline",
    "archived": false,
    "key": "welcome-message",
    "created_at": "2023-02-17T11:43:55Z",
    "updated_at": "2026-06-08T16:47:11Z",
    "content": "Hello {{ subscriber.first_name }}",
    "document": {
      "id": 174,
      "value": null,
      "value_html": "content",
      "value_plain": null,
      "version": 1
    }
  }
}

Snippets

Update a snippet

Rename a snippet, replace its body, or archive/restore it. Updates apply on the next send of any email that references the snippet via {{ snippet.key }} — there’s no per-email versioning, so a content change ripples to every broadcast or sequence email using that key.

The request body must match the existing snippet_type. For an inline snippet, send content (and optionally name, archived). For a block snippet, send document_attributes.value_html (and optionally name, archived). Pass archived: true to archive, false to restore.

Warning: snippet_type is immutable. Sending a different value, or sending the body shape for the wrong type, returns a 422 with snippet_type cannot be changed.

See Create a snippet for the full snippet model and how key ties into Liquid.

PUT

snippets

{id}

Update a snippet

curl --request PUT \
  --url https://api.kit.com/v4/snippets/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-Kit-Api-Key: <api-key>' \
  --data '
{
  "name": "Dog Fact of the Day"
}
'

{
  "snippet": {
    "id": 59,
    "name": "Dog Fact of the Day",
    "snippet_type": "inline",
    "archived": false,
    "key": "welcome-message",
    "created_at": "2023-02-17T11:43:55Z",
    "updated_at": "2026-06-08T16:47:11Z",
    "content": "Hello {{ subscriber.first_name }}",
    "document": {
      "id": 174,
      "value": null,
      "value_html": "content",
      "value_plain": null,
      "version": 1
    }
  }
}

Authorizations

X-Kit-Api-Key

string

header

required

Authenticate API requests via an API Key

Path Parameters

integer

required

Body

application/json

Inline snippet
Block snippet

name

string

New name for the snippet

snippet_type

string

Cannot be changed — must match the existing type if provided

archived

boolean

Pass true to archive or false to restore the snippet

content

string

New Liquid-enabled text content

Response

Updates the snippet and returns its details

snippet

object

required

Show child attributes

Get a snippet List webhooks

⌘I