Bellwork
Start free
OrgEmail templatesTemplateid

Update an email template

Partial update; at least one field is required (an empty body is rejected with 400 rather than silently doing nothing).

PATCH
/org/email-templates/{templateId}

Partial update; at least one field is required (an empty body is rejected with 400 rather than silently doing nothing).

Authorization

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Path Parameters

templateId*string
Formatuuid

Request Body

application/json

name?string

Template display name

Length1 <= length <= 255
when_to_use?string

Guidance for when to auto-pick this template

Length1 <= length
example_subject?string

Example email subject the AI mimics

Length1 <= length
example_body?string

Example email body the AI mimics

Length1 <= length
instructions?|

Optional additional instruction rules

is_active?boolean

Whether this template is available for use (defaults to true)

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://loading/api/v1/org/email-templates/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "org_id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "string",
    "when_to_use": "string",
    "example_subject": "string",
    "example_body": "string",
    "instructions": "string",
    "is_active": true,
    "created_by": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "string",
    "updated_at": "string",
    "usage_count": 0
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "module_required",
  "module": "string",
  "message": "string",
  "contact": "string"
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Get an email template GET

Previous Page

List drafts written from a template GET

Every saved draft that followed this template, newest first — the read behind the usage count on the Templates page. Org-scoped twice over: the template must belong to the caller's org, and drafts are constrained to the org's member profiles (generated_emails carries no org_id).