Get one template version including source
Returns a single published version of the template addressed by idOrSlug, selected by the version path segment (a positive integer).
Returns a single published version of the template addressed by idOrSlug, selected by the version path segment (a positive integer). The response is a bare object: "template_version" carrying version, source, subject, variables, notes, and createdAt — the immutable snapshot exactly as it renders and sends. Unlike the list endpoints, this call includes the full source. Responds 404 when the template does not exist, is archived, or that version was never published, and 400 when version is not a positive integer. Requires the templates:read scope.
Scope: templates:read. Send the API key as a bearer token; Scopes lists what each one reaches.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
idOrSlug | string | yes | Template UUID or slug. |
version | integer | yes | (minimum 1) |
Response
200 Success. Body: application/json, TemplateVersionDetailResponse.
| Field | Type | Required | Description |
|---|---|---|---|
templateId | string (uuid) | yes | |
version | TemplateVersionDetail | yes |
Errors
Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.
| Status | Meaning |
|---|---|
400 | The request is malformed or a value is invalid (invalid_request, invalid_domain, idempotency_key_mismatch). |
401 | The API key is missing or invalid. |
403 | The key lacks the scope this endpoint needs (scope_missing) or may not do this (not_permitted). |
404 | No such resource in this account (resource_not_found). |
422 | The request is well-formed but a field failed validation (validation_failed). |
429 | Rate limit, plan limit, budget or spend cap reached (rate_limited, plan_limit_reached, budget_exceeded, spend_cap_reached). |
500 | An unexpected error; retry with backoff, then contact support (internal_error). |
Publish a new immutable template version
Publishes a new immutable version of the template addressed by idOrSlug and assigns it the next sequential version number.
List email threads
Returns a keyset-paginated list of the caller's threads, most-recent activity first — ordered by lastMessageAt descending, with threads that have no messages yet sorted last.