Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.reflecto.dev/llms.txt

Use this file to discover all available pages before exploring further.

Send your first Reflecto notification in under a minute.

1. Get a token

  1. Open the Reflecto Android app.
  2. Tap Settings → API Tokens.
  3. Your Default token is created automatically on first install. Tap Reveal (biometric-gated) and copy the rfk_live_… value.
The plaintext token is shown once. Reflecto stores only a SHA-256 hash on the server — if you lose the value, revoke the token and create a new one.

2. Send a notification

curl -H "Authorization: Bearer rfk_live_aB3xQ7mN9pK2vR5tY8uW4sZ1cE6dF0gH" \
     -d "Backup completed successfully" \
     https://api.reflecto.dev/v1/send
A successful call returns:
{
  "id": "msg_abc123def456",
  "delivered_to": [
    { "device_id": "did_phone_uuid", "type": "android" },
    { "device_id": "did_chrome_uuid", "type": "extension" }
  ],
  "warnings": []
}
Within three seconds you should see the notification on your phone (system tray, “via Default”) and on every paired extension.

3. Target a specific device

curl -H "Authorization: Bearer $REFLECTO_TOKEN" \
     -d "device=phone&message=phone only" \
     https://api.reflecto.dev/v1/send
Built-in selectors: all (default), mobile/phone, desktop. You can also use any custom label you assigned during pairing, or a comma-separated list. Unknown labels become warnings, not errors.

Next steps

  • Authentication — token lifecycle, rotation, revoke.
  • Rate limits — burst, monthly, per-receiver caps.
  • Errors — every status code and stable error code.