---
title: "CreateAlert adds a virtual file for an alert, triggers a reconcile, and waits for the alert to be added to the runtime catalog"
method: POST
path: "/v1/orgs/{org}/projects/{project}/alerts"
---

# CreateAlert adds a virtual file for an alert, triggers a reconcile, and waits for the alert to be added to the runtime catalog

`POST /v1/orgs/{org}/projects/{project}/alerts`

## Path parameters

- `org` string, required
- `project` string, required

## Request body

- object
  - `options` V1AlertOptions
    - `displayName` string
    - `emailRecipients` string[]
    - `intervalDuration` string
    - `metricsViewName` string
    - `queryArgsJson` string — DEPRECATED: Use resolver and resolver_properties instead.
    - `queryName` string — DEPRECATED: Use resolver and resolver_properties instead.
    - `refreshCron` string
    - `refreshTimeZone` string
    - `renotify` boolean
    - `renotifyAfterSeconds` integer
    - `resolver` string
    - `resolverProperties` object
    - `slackChannels` string[]
    - `slackUsers` string[]
    - `slackWebhooks` string[]
    - `webOpenPath` string — Annotation for the subpath of <UI host>/org/project to open for the report.
    - `webOpenState` string — Annotation for the base64-encoded UI state to open for the report.

## Response `200`

A successful response.

- V1CreateAlertResponse
  - `name` string

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rilldata/apis/rill-admin-api.md) · [All operations](https://skmtc.net/rilldata/apis/rill-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rilldata/rill-admin-api/versions/289a0ca9ce49/schema)