Schedule a Personal Reminder
schedule_reminderDestructive
Remind the authenticated user later: a timer, alarm, ping, or reminder delivered by Pushary even after the agent exits. One-time only; up to 30 days away, 25 pending per user/site. Provide body plus inMinutes or at with an explicit UTC offset. Use a unique requestId for each schedule and reuse it unchanged on retries. Use reminderId to retrieve the final outcome. Confirm the returned time and report any warning. Omit arguments to list pending reminders; use cancelReminderId to cancel a scheduled one. Never use ask_user for a reminder. Does not schedule agent work or customer campaigns. Respects stop/mute and active membership at delivery.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | Future ISO 8601 timestamp with explicit UTC offset or Z, at most 30 days away. Resolve the user's local time and timezone before scheduling; never guess a timezone. | |
| env | No | ||
| body | No | What to remind the authenticated user about, at most 180 UTF-16 units after secret redaction (emoji may use two). Omit all fields to list their pending reminders. | |
| title | No | ||
| agentName | No | ||
| inMinutes | No | Minutes from the server clock; use for timers and relative reminders. | |
| machineId | No | ||
| requestId | No | Unique ID for this scheduling operation. Reuse it unchanged on retries to return the original reminder, including after it settles. | |
| sessionId | No | ||
| reminderId | No | Look up your reminder, including its final outcome and delivery status, instead of scheduling or cancelling. | |
| cancelReminderId | No | Cancel this user's scheduled reminder instead of creating one. Already-dispatching reminders cannot be cancelled. |