---
title: "Create My Reminder"
method: POST
path: "/me/reminders"
tags: ["auth", "auth"]
---

# Create My Reminder

`POST /me/reminders`

## Request

- Base URL: `https://api.agent4.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.agent4.io/me/reminders`
- Auth: none declared

**手动**建一条提醒。

在这之前，提醒只能由模型调 `schedule_reminder` 建出来——用户想自己加一条，界面上没有任何
地方可点。而"我知道我要什么，让我直接填"是一条**确定性**的路：不经自然语言解析，
填错了当场就有话说，不会变成一个永远不触发的东西。

规则（时区怎么解释、上限、什么算过去）与工具那条路**共用同一份**
（`app/push/reminders.py`）——抄一遍的话，两处错开的那天不会有任何报错。

## Request body

- NewReminderIn: 面板上那张表。**传的是意图，不是 cron**——见 `app/push/reminders.py` 的说明。
  - `instruction` string, required
  - `title` string
  - `mode` string
  - `at` string
  - `date` string
  - `weekday` integer, nullable
  - `day` integer, nullable
  - `tz_hint` string

## Response `201`

Successful Response

- MyReminderOut
  - `id` string, required
  - `title` string, nullable
  - `run_at` string, date-time, required
  - `cron` string, nullable
  - `status` string, required
  - `channel` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agent4/apis/chatagent-platform.md) · [All operations](https://skmtc.dev/agent4/apis/chatagent-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/agent4/apis/chatagent-platform/revisions/18e58f082ce3?raw)