---
title: "List alert templates"
method: GET
path: "/api/{org_id}/alerts/templates"
tags: ["Templates"]
---

# List alert templates

`GET /api/{org_id}/alerts/templates`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/alerts/templates`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/alerts/templates/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of all alert notification templates configured for an organization. Returns template names, types, and basic metadata to help administrators manage notification formatting options. Templates provide reusable formatting configurations that ensure consistent alert notifications across different channels and destinations.

## Path parameters

- `org_id` string, required

## Query parameters

- `applies_to` string, nullable
- `type` string, nullable

## Response `200`

Success

- object[]
  - `applies_to` string[], nullable: Kinds the template is meant for; [] is every kind. Absent on update keeps the stored list.
  - `body` string
  - `isDefault` boolean, nullable
  - `isPrebuilt` boolean: True for system-managed prebuilt templates (those whose name starts with `prebuilt_`). The public API refuses updates and deletes for these, so the UI should render them as read-only.
  - `kind` string, nullable: Template kind: "custom" (default) or "content". Absent on write means "unspecified" — create defaults to custom, update preserves the stored kind (sticky-kind rule, design §6.2).
  - `name` string
  - `title` string
  - `type` 'http' | 'email' | 'sns' | 'slack_app'

## Other responses

- `400`: Error

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)