Skip to content

Docs: copy the API spec, add text_unchecked, the template check and variable kinds - #37

Merged
farhadhf merged 4 commits into
mainfrom
docs/text-unchecked-issue
Oct 19, 2026
Merged

farhadhf merged 4 commits into
mainfrom
docs/text-unchecked-issue

Conversation

@farhadhf

@farhadhf farhadhf commented Oct 18, 2026 •

Copy link
Copy Markdown
Contributor

Copies openapi.yaml and webhooks.yaml from the server and documents what they add:

  • The text_unchecked campaign issue on the Campaigns overview.
  • The template check on Create Message, Create Template Message, Create Conversation and Test Campaign: a 400 for content that cannot be rendered, and a 503 with Retry-After when the check cannot run right now. Covered on the Errors, Sending, Transactional templates, Idempotency and Test Campaign pages, and in the October changelog.
  • The kind of each template variable (value, condition, list) and item_fields for list variables. A new "Kinds of variables" section on the Transactional templates page, with a list example, linked from Get Template, Get Template Version and Create Template Message, and in the October changelog.

The spec copy also brings in description changes: rate-limit Retry-After, sender and recipient names, bcc, the to header, webhook signatures, retry counts, route deliveries, and the sender address on webhook events.

Merge after the release.

… 503

The API spec now describes the check every API v2 send and campaign test
goes through before it is sent: content that cannot be rendered is refused
with 400, and a check that cannot run right now answers 503 with
Retry-After. The errors, sending, template and Test Campaign pages say how
to read and retry each answer, and the October changelog lists the change.
@farhadhf farhadhf changed the title Docs: copy the API spec from the server and add text_unchecked Docs: copy the API spec from the server, add text_unchecked and the template check Oct 19, 2026
…ables

The API spec now gives each variable of a transactional template a kind:
value, condition or list, and a list variable names the fields of its
elements. The Transactional templates page explains what to send for each
kind with a list example, the Get Template, Get Template Version and
Create Template Message pages point to it, and the October changelog
lists the change.
@farhadhf farhadhf changed the title Docs: copy the API spec from the server, add text_unchecked and the template check Docs: copy the API spec, add text_unchecked, the template check and variable kinds Oct 19, 2026
…able kinds

A published template has no draft, so publishing alone makes no new
version; the reader has to make an edit and save it first. The kinds
table also said a condition takes any value, while an empty value hides
the part.
@farhadhf
farhadhf merged commit 49b0df5 into main Oct 19, 2026
2 checks passed
@farhadhf
farhadhf deleted the docs/text-unchecked-issue branch October 19, 2026 12:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant