Schedule a reminder notification on your paired phone

curl --request POST \
  --url https://api.reflecto.dev/v1/reminders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "Stand-up in 10 minutes",
  "at": 1786387000
}
'

import requests

url = "https://api.reflecto.dev/v1/reminders"

payload = {
    "message": "Stand-up in 10 minutes",
    "at": 1786387000
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({message: 'Stand-up in 10 minutes', at: 1786387000})
};

fetch('https://api.reflecto.dev/v1/reminders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.reflecto.dev/v1/reminders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => 'Stand-up in 10 minutes',
    'at' => 1786387000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.reflecto.dev/v1/reminders"

	payload := strings.NewReader("{\n  \"message\": \"Stand-up in 10 minutes\",\n  \"at\": 1786387000\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.reflecto.dev/v1/reminders")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"Stand-up in 10 minutes\",\n  \"at\": 1786387000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reflecto.dev/v1/reminders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"Stand-up in 10 minutes\",\n  \"at\": 1786387000\n}"

response = http.request(request)
puts response.read_body

{
  "reminder_id": "rmd_3f6e2a7c9b1d4f8e8a5b6c1d2e3f4a5b",
  "fire_at": 1786387000
}

Reminders

Schedule a reminder notification on your paired phone

Schedules a reminder — the remind_me MCP tool’s backing endpoint. The phone (not the server) owns the schedule: the server encrypts the message once, delivers it to the paired phone immediately over FCM, and retains nothing (spec D3) — the phone arms a local alarm and fires the reminder notification at at.

at is an absolute Unix epoch in seconds, and must be between 60 seconds and 365 days in the future (400 fire_at_too_soon / 400 fire_at_too_far). The delivery to the phone is best-effort like any other push — a phone that never receives the setup message never arms the alarm.

Requires a paired phone device on the account behind the bearer token (409 no_phone_device).

Phone-capability gate. If the paired phone’s reported app build is too old to schedule reminders, the request is refused outright (426 phone_app_outdated) rather than accepted and silently dropped on arrival — a later app update can’t rescue a message that already arrived and was ignored. A phone that has never reported its version is allowed through instead, with a warnings entry naming the uncertainty.

POST

reminders

Schedule a reminder notification on your paired phone

curl --request POST \
  --url https://api.reflecto.dev/v1/reminders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "Stand-up in 10 minutes",
  "at": 1786387000
}
'

import requests

url = "https://api.reflecto.dev/v1/reminders"

payload = {
    "message": "Stand-up in 10 minutes",
    "at": 1786387000
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({message: 'Stand-up in 10 minutes', at: 1786387000})
};

fetch('https://api.reflecto.dev/v1/reminders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.reflecto.dev/v1/reminders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => 'Stand-up in 10 minutes',
    'at' => 1786387000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.reflecto.dev/v1/reminders"

	payload := strings.NewReader("{\n  \"message\": \"Stand-up in 10 minutes\",\n  \"at\": 1786387000\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.reflecto.dev/v1/reminders")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"Stand-up in 10 minutes\",\n  \"at\": 1786387000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reflecto.dev/v1/reminders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"Stand-up in 10 minutes\",\n  \"at\": 1786387000\n}"

response = http.request(request)
puts response.read_body

{
  "reminder_id": "rmd_3f6e2a7c9b1d4f8e8a5b6c1d2e3f4a5b",
  "fire_at": 1786387000
}

Authorizations

Authorization

string

header

required

Opaque bearer token created on your paired Android phone. The format is rfk_live_ followed by 32 URL-safe alphanumeric characters (≥160 bits of entropy). Test tokens use the rfk_test_ prefix.

Body

application/json

message

string

required

Notification text delivered when the reminder fires. 1–500 characters.

Example:

"Stand-up in 10 minutes"

integer

required

Absolute Unix epoch SECONDS when the reminder should fire. Must be 60 seconds to 365 days in the future.

Example:

1786387000

Response

Created — the reminder setup message was dispatched to the phone.

reminder_id

string

required

Reminder id (rmd_ prefix). Pass it to DELETE /v1/reminders/{id} to cancel.

Example:

"rmd_3f6e2a7c9b1d4f8e8a5b6c1d2e3f4a5b"

fire_at

integer

required

Unix epoch seconds the reminder is scheduled for (echoes the requested at).

Example:

1786387000

warnings

string[]

Present when the phone hasn't reported an app version yet, so the server can't confirm it supports reminders — the setup message may be silently dropped if the installed build predates support. Omitted entirely once the phone's reported version is known to support it.

Example:

[
  "the paired phone hasn't reported its app version yet, so we can't confirm it supports this — it may be silently dropped if the installed build predates support"
]