Liệt kê template

Mọi template trên connection, mới nhất trước, phân trang theo keyset.

export OE=https://api.openemail.ukexport AUTH="Authorization: Bearer $OPENEMAIL_API_KEY"

Một template là một phần thân được lưu một lần và gửi nhiều lần, và nó thuộc về CONNECTION chứ không thuộc về người đã viết nó. Một key của workspace nhìn thấy đúng những template mà đồng nghiệp nhìn thấy, và xóa tài khoản của tác giả không kéo chúng đi theo.

engine: "blocks" lưu một cây mà các loại node là các export của @react-email/components (Section, Row, Column, Container, Text, Heading, Button, Link, Img, Hr, Markdown, CodeBlock và CodeInline) và props là props của chính các component đó. Nó được kiểm tra ngay khi đi vào, nên một node sai là một 422 trên chính lệnh gọi đã ghi nó, chứ không phải một email hỏng về sau.

engine: "html" lưu markup bạn đã có sẵn, được làm sạch một lần khi phiên bản được xuất bản. Đây là lựa chọn khi template của bạn là các component react-email nằm trong repo của chính bạn: hãy render component bằng @react-email/render trong bản build của bạn rồi gửi kết quả lên. Không có endpoint JSX và sẽ không bao giờ có. API nhận HTML vì HTML là thứ mail client đọc, còn thực thi component của caller chỉ để đổi lấy một sandbox chẳng ai cần.

Cả hai đều được viết dạng {{key}} trong phần thân và trong subject, và cả hai đều mang một kind (text, url hoặc image) quyết định giá trị được escape thế nào khi thay thế. Một key không được khai báo ở đâu sẽ hỏng khi xuất bản; một giá trị url có scheme không phải http, https hay mailto bị từ chối thay vì được render.

Cần templates:read. limit tối đa 100, status thu hẹp về draft, active hoặc archived, và cursor là giá trị mờ, nên hãy truyền lại nextCursor bạn nhận được thay vì tự dựng.

curl "$OE/templates?limit=25&status=active" -H "$AUTH"

{  "object": "list",  "data": [    {      "object": "template",      "id": "tpl_9c1f0a4b7e05d3862c1f0a44",      "name": "Order shipped",      "slug": "order-shipped",      "description": null,      "status": "active",      "publishedVersion": 3,      "latestVersion": 4,      "createdAt": "2026-08-01T09:12:44.000Z",      "updatedAt": "2026-08-28T16:03:10.000Z"    }  ],  "hasMore": false,  "nextCursor": null}