List templates — StatusDashboard Docs

GET /app/templates

Returns org-scoped event templates. Requires the templates plan feature and admin or event role.

Request

See API Basics for required headers.

Query parameters

Parameter	Type	Default	Description
`eventType`	string	—	Filter: `"incident"`, `"maintenance"`, or `"informational"`.
`q`	string	—	Case-insensitive search on `name` and `title`. Max 100 characters.
`sort`	string	`updatedAt`	`"updatedAt"` or `"name"`.
`order`	string	`desc` for `updatedAt`, `asc` for `name`	`"asc"` or `"desc"`.
`limit`	number	`100`	Max items returned. Min `1`, max `100`.

Sample request

curl "https://api.statusdashboard.com/app/templates?eventType=incident&limit=50" \
  -H "Authorization: Bearer bcf847abf5c6:def456"

Sample response

Status: 200 OK

{
  "templates": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Database outage playbook",
      "eventType": "incident",
      "title": "Database connectivity issues",
      "description": "We are investigating database connectivity problems.",
      "notifications": true,
      "createdAt": "2026-01-10T12:00:00.000Z",
      "updatedAt": "2026-04-01T08:00:00.000Z"
    }
  ],
  "limits": {
    "templates": 100
  }
}

Response fields

Field	Type	Description
`templates`	array	Matching templates for this request. Each item has the same shape as Get template (`template` object fields, without the outer `limits` wrapper).
`limits.templates`	number	Max templates for your organization.

Templates include playbook fields only (no components, status, timeline message, publish, or schedule times). Writable fields match Create template. See Templates.

Error responses

Status	When
`403`	Templates feature not enabled or insufficient role.