v50

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-06-1841147599.2 KB

Templates

Update a template

Updates an existing template's name, category, language, definition, or submits it for review.

put/v3/templates/{id}

Path parameters

idstring uuid required

Template ID from route parameter

Headers

Idempotency-Keystring

Unique key to ensure idempotent request processing. Must be 1-255 alphanumeric characters, hyphens, or underscores. Responses are cached for 24 hours per key per customer.

x-profile-idstring uuid

Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.

Request body

sandboxboolean

Sandbox flag - when true, the operation is simulated without side effects Useful for testing integrations without actual execution

namestring nullable

Template display name

categorystring nullable

Template category: MARKETING, UTILITY, AUTHENTICATION

languagestring nullable

Template language code (e.g., en_US)

submit_for_reviewboolean

Whether to submit the template for review after updating (default: false)

Example request

{
  "name": "Updated Welcome Message",
  "category": "MARKETING",
  "language": null,
  "definition": null,
  "submit_for_review": false,
  "sandbox": false
}

Response

Template updated successfully

successboolean

Indicates whether the request was successful