---
title: "List alerts"
method: GET
path: "/v1/projects/{project_id}/alerts"
tags: ["Alerts"]
---

# List alerts

`GET /v1/projects/{project_id}/alerts`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/projects/{project_id}/alerts`
- Auth: HTTP bearer

Human owner/member view of alert definitions and current state. Unattended runners do not poll this route; they consume exact server-issued alert trigger receipts.

## Path parameters

- `project_id` string, required

## Query parameters

- `state` 'triggered' | 'recovered'

## Response `200`

OK

- object
  - `alerts` object[], required
  - `next_action` string

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/agentry/apis/agentry-api.md) · [All operations](https://skmtc.dev/agentry/apis/agentry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentry/apis/agentry-api/revisions/abdecddf009f?raw)