SUsuprsend

List Templates

Changed on

Retrieve a paginated list of templates in a workspace. Returns template metadata including name, slug, status, enabled channels, and per-channel variant counts.

get/v2/{workspace}/template/

Request

Path parameters

workspacestring required

Workspace slug (e.g., staging, production).

Query parameters

mode'draft' | 'live'

Return draft or live version of templates.

limitinteger

Number of results per page.

offsetinteger

Offset for pagination.

searchstring

Search by template name, slug or description.

slugsstring

Filter by template slugs, comma separated.

Response

Successfully retrieved list of templates

Example response

{
  "meta": {
    "count": 22,
    "limit": 10
  },
  "results": [
    {
      "$schema": "https://schema.suprsend.com/template/v2/schema.json",
      "name": "Order Confirmation Email",
      "slug": "order-confirmation-email",
      "enabled_channels": [
        "email",
        "inbox"
      ],
      "status": "active"
    }
  ]
}

Changes

  • 5f0169085547Revision changes
    • breaking

      for the query request parameter limit, default value was changed from 20 to 10

    • breaking

      response property detail list-of-types was widened by adding types array and object to media type application/json of response 401

    • warning

      deleted the query request parameter q

    • info

      added the new optional query request parameter search

    • info

      added the new optional query request parameter slugs