List email templates synced from GitHub

Search Documentation

Search across all developer documentation

entities

List email templates synced from GitHub

GET /v1/templates
Auth required api.templates.view

Returns the org's email templates, sourced from the GitHub repo declared in your sendops.json manifest. This endpoint is read-only — templates are managed by committing changes to the repo. Sorted newest-first. version is the short (7-char) Git commit SHA of the most recent sync.

Query parameters

limit integer optional

Page size (1–200). Default 50.

cursor string optional

Opaque cursor returned from the previous page.

Responses

Errors follow the RFC 7807 problem format — see the error reference.

200 Templates, newest-first application/json
data array<object> required

Each entry in data:

slug string required

Template file name (e.g. welcome.html).

name string required

Same as slug today (no separate display-name column).

subject string | null required

Always null in v1 — subject is not tracked as a column. Reserved for future use.

channel string | null required

Always null in v1 — template-to-channel binding is not tracked as a column. Reserved for future use.

version string required

Short (7-char) Git commit SHA of the last sync. Empty string for legacy rows synced before SHAs were tracked.

last_modified_at string<date-time> required

Time the template was last synced — not the upstream commit timestamp.

source string enum required

One of: git

pagination object required

Fields of pagination:

has_more boolean required
next_cursor string | null optional
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
422 Query parameter or path value failed validation application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json