Update template

PATCH

https://api.talktohumans.app

templates

{template_id}

curl --request PATCH \
  --url https://api.talktohumans.app/v1/templates/{template_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Event follow-up (short)"
}
'

{
  "data": {
    "template": {
      "template_id": "tpl_6f1d2c3a-8b4e-4f5a-9c7d-2e1b0a9f8c7d",
      "name": "Event follow-up",
      "type": "message",
      "scope": "shared",
      "content": "Hi {{first_name}}, great meeting you at {{event_name}}. Open to a quick call?",
      "created_at": "2026-06-02T12:00:00Z",
      "updated_at": "2026-06-09T12:00:00Z"
    }
  }
}

Authorizations

Authorization

string

header

required

Pass API key as Authorization: Bearer <api_key>.

Path Parameters

template_id

string

required

Template ID returned by GET /v1/templates or POST /v1/templates.

Body

application/json

Provide at least one of name, content, or steps. Omitted fields are unchanged.

name

string

Template name shown in TalkToHumans.

Required string length: 1 - 200

content

string

Plain-text message. Message templates only.

Minimum string length: 1

steps

object[]

Replacement for all steps. Sequence templates only.

Minimum array length: 1

Show child attributes

Response

Template updated.

data

object

required

Show child attributes

curl --request PATCH \
  --url https://api.talktohumans.app/v1/templates/{template_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Event follow-up (short)"
}
'

{
  "data": {
    "template": {
      "template_id": "tpl_6f1d2c3a-8b4e-4f5a-9c7d-2e1b0a9f8c7d",
      "name": "Event follow-up",
      "type": "message",
      "scope": "shared",
      "content": "Hi {{first_name}}, great meeting you at {{event_name}}. Open to a quick call?",
      "created_at": "2026-06-02T12:00:00Z",
      "updated_at": "2026-06-09T12:00:00Z"
    }
  }
}

Conversations

Templates

Contacts

Companies

Enrich

Views

Accounts

Activity

Authorizations

Path Parameters

Body

Response