템플릿 목록 조회

connection의 모든 템플릿을 최신순으로, 키셋 페이지네이션으로 돌려줍니다.

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

템플릿은 한 번 저장해 여러 번 보내는 본문이며, 작성자가 아니라 connection에 속합니다. 워크스페이스 키는 동료와 같은 템플릿을 보고, 작성자의 계정을 삭제해도 템플릿은 함께 사라지지 않습니다.

engine: "blocks"는 노드 종류가 @react-email/components의 export(Section, Row, Column, Container, Text, Heading, Button, Link, Img, Hr, Markdown, CodeBlock, CodeInline)이고 props가 해당 컴포넌트 자체의 props인 트리를 저장합니다. 입력 시점에 검증되므로, 잘못된 노드는 나중에 깨진 이메일이 아니라 그것을 쓴 호출에서 422로 드러납니다.

engine: "html"은 이미 가지고 있는 마크업을 저장하며, 버전이 게시될 때 한 번 살균 처리합니다. 템플릿이 자체 저장소에 있는 react-email 컴포넌트라면 이쪽을 쓰세요. 자체 빌드에서 @react-email/render로 컴포넌트를 렌더링한 뒤 그 결과를 POST하면 됩니다. JSX 엔드포인트는 없고 앞으로도 없을 것입니다. 메일 클라이언트가 읽는 것이 HTML이기 때문에 이 API는 HTML을 받으며, 호출자의 컴포넌트를 실행한다면 아무도 필요로 하지 않는 샌드박스를 떠안게 됩니다.

둘 다 본문과 제목에서 {{key}} 형태로 적으며, 둘 다 kind(text, url, image)를 가지고 이 값이 치환될 때의 이스케이프 방식을 결정합니다. 아무 데서도 선언하지 않은 키는 게시 시점에 실패하고, 스킴이 http, https, mailto가 아닌 url 값은 렌더링되지 않고 거부됩니다.

templates:read가 필요합니다. limit은 100까지이고, status는 draft, active, archived로 범위를 좁히며, cursor는 불투명한 값이므로 직접 만들지 말고 받은 nextCursor를 그대로 돌려보내세요.

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}