Update a template

Body parameters

All fields are optional; omitted fields keep their current value.

string

New display name.

string

New subject line.

string | null

New HTML body. Pass null to clear it.

string | null

New plain-text body. Pass null to clear it.

string

New slug. Must stay unique within the project.

Request

curl https://api.drin.run/v1/templates/tmpl_8XQ2k9 \
  -X PATCH \
  -H "Authorization: Bearer $DRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Your receipt — order {{orderId}}",
    "text": "Hi {{firstName}}, thanks for your order."
  }'

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

const template = await drin.templates.update("tmpl_8XQ2k9", {
  subject: "Your receipt — order {{orderId}}",
  text: "Hi {{firstName}}, thanks for your order.",
});

Response

Returns the full template with a refreshed updatedAt and a recomputed variables list.

200 OK

{
  "id": "tmpl_8XQ2k9",
  "slug": "order-receipt",
  "name": "Order Receipt",
  "subject": "Your receipt — order {{orderId}}",
  "html": "<p>Hi {{firstName}}, thanks for your order.</p>",
  "text": "Hi {{firstName}}, thanks for your order.",
  "variables": ["firstName", "orderId"],
  "createdAt": "2026-06-02T10:00:00.000Z",
  "updatedAt": "2026-06-02T11:30:00.000Z"
}

Slug collisions. Changing slug to one already taken in the project returns 409 conflict (template_slug_taken).

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

Update a template

Path parameters

Body parameters

Request

Response

​Path parameters

​Body parameters

​Request

​Response

Path parameters

Body parameters

Request

Response