---
title: "POST /v1/alert/alert-pages"
method: POST
path: "/v1/alert/alert-pages"
tags: ["Alert"]
---

# POST /v1/alert/alert-pages

`POST /v1/alert/alert-pages`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- MarksmanApiV1CreateAlertPageRequest: CreateAlertPageRequest creates a new alert page.
  - `name` string
  - `color` string
  - `sortOrder` integer
  - `filter` MarksmanApiV1AlertPageFilter: AlertPageFilter defines which alerts belong to a page (any match).
    - `strategyGroupUids` string[]
    - `levelUids` string[]
    - `strategyUids` string[]
    - `datasourceUids` string[]
    - `datasourceLevelUids` string[]

## Response `200`

OK

- MarksmanApiV1CreateAlertPageReply
  - `uid` string

## Changes

- **2026-03-26** `f04c32a060a2`: 2 info
  - added the new optional request property `filter/datasourceLevelUids`
  - added the new optional request property `filter/datasourceUids`
- **2026-03-18** `3b5c353785ca`: 1 info
  - endpoint added
- **2026-02-28** `f5912329bb01`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/changes/v1/alert/alert-pages/post.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-marksman-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/revisions/26ae221fccba?raw)