Schedule a Personal Reminder to Remind Them Later
schedule_reminderSchedule, list, retrieve or cancel a personal Pushary reminder for the authenticated user. Scheduled reminders can arrive after the agent exits. One-time only; up to 30 days away, 25 pending per user/site. Scheduling requires body and either inMinutes or at with an explicit UTC offset. requestId identifies one schedule across retries. reminderId retrieves its outcome; no arguments lists pending reminders; cancelReminderId cancels a pending reminder. Returns the scheduled time, state and any delivery warning. Delivery respects stop/mute and active membership. Does not schedule agent work or customer campaigns. API reference: https://pushary.com/docs/agents/reference/tools#schedule_reminder
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "schedule_reminder"
}
}Input 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | Yes | What the result means and what to do next. | |
| pending | Yes | The authenticated user's pending reminders on this site, soonest first. | |
| warning | No | Present when no phone is connected, so the reminder will appear only in the Pushary Mac app. | |
| delivery | No | Push delivery counts for a reminder looked up by reminderId. | |
| reminder | No | The reminder this call scheduled, matched or looked up. Absent when listing, when cancelling, and when reminderId found nothing. | |
| cancelled | No | Present when cancelReminderId was passed. True when a scheduled reminder was cancelled; false when it was not found or already dispatching or final. | |
| duplicate | No | True when scheduling returned an existing reminder: a retried requestId, or the same reminder scheduled moments earlier. |