Repository navigation
API reference
Generated by packaging/scripts/gen-api-docs.py. Do not hand-edit.
Index
Config
Health
Overall health plus a per-device summary.
| name | in | required | type |
|---|---|---|---|
| device_id | query | False | string |
| timezone | query | False | string |
Public: feeds the lock sweep and findplus version --check.
Compact, lock-aware feed for the Tauri menu-bar widget (E16).
Lock Requirements
Whether the app is locked right now. Always reachable.
| name | in | required | type |
|---|---|---|---|
| findplus_session | cookie | False | string |
Lock immediately (manual button, or the client's idle timer).
| name | in | required | type |
|---|---|---|---|
| findplus_session | cookie | False | string |
Exchange a correct PIN for a session cookie. Rate-limited.
Request body:
{
"properties": {
"pin": {
"type": "string",
"title": "Pin"
}
},
"type": "object",
"required": [
"pin"
],
"title": "Body_unlock_api_lock_unlock_post"
}Remove the PIN and disable the lock. Requires the current PIN.
Request body:
{
"properties": {
"current_pin": {
"type": "string",
"title": "Current Pin"
}
},
"type": "object",
"required": [
"current_pin"
],
"title": "Body_remove_pin_api_settings_pin_delete"
}Read Settings
Get Start At Login
The effective value, resolved exactly as GET /api/widget resolves it.
Toggle the desktop app's LaunchAgent through findplus.service.
Request body:
{
"properties": {
"value": {
"type": "boolean",
"title": "Value"
}
},
"type": "object",
"required": [
"value"
],
"title": "Body_set_start_at_login_api_settings_app_start_at_login_post"
}Set or change the PIN. Changing it requires the existing one.
Request body:
{
"properties": {
"new_pin": {
"type": "string",
"title": "New Pin"
},
"current_pin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Current Pin"
}
},
"type": "object",
"required": [
"new_pin"
],
"title": "Body_set_pin_api_settings_pin_post"
}Persist whether the widget renders a map snapshot.
Request body:
{
"properties": {
"value": {
"type": "boolean",
"title": "Value"
}
},
"type": "object",
"required": [
"value"
],
"title": "Body_set_widget_show_map_api_settings_widget_show_map_post"
}Write Settings
Request body:
{
"properties": {
"theme": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Theme"
},
"idle_minutes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Idle Minutes"
},
"lock_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Lock Enabled"
}
},
"type": "object",
"title": "Body_write_settings_api_settings_put"
}Persist whether the widget renders a map snapshot.
Request body:
{
"properties": {
"value": {
"type": "boolean",
"title": "Value"
}
},
"type": "object",
"required": [
"value"
],
"title": "Body_set_widget_show_map_api_settings_widget_show_map_put"
}Devices
Set which device the dashboard focuses on first.
Request body:
{
"properties": {
"device_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Device Id"
}
},
"type": "object",
"title": "Body_choose_default_api_devices_default_post"
}Re-query every authenticated provider for its device list.
Replace the tracked set. all_devices=true tracks everything.
Request body:
{
"properties": {
"device_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Device Ids"
},
"all_devices": {
"type": "boolean",
"title": "All Devices",
"default": false
}
},
"type": "object",
"title": "Body_set_tracked_api_devices_track_post"
}Local dates holding data. Omit device_id for every device.
| name | in | required | type |
|---|---|---|---|
| device_id | query | False | string |
| timezone | query | False | string |
Export History
| name | in | required | type |
|---|---|---|---|
| fmt | query | False | string |
| day | query | False | string |
| start | query | False | string |
| end | query | False | string |
| device_id | query | False | string |
| group_id | query | False | string |
| timezone | query | False | string |
Newest stored observation. Reads local history; does not query Google.
| name | in | required | type |
|---|---|---|---|
| device_id | query | False | string |
| timezone | query | False | string |
Poll Runs
| name | in | required | type |
|---|---|---|---|
| limit | query | False | integer |
One day of history, as one INDEPENDENT track per device.
| name | in | required | type |
|---|---|---|---|
| day | query | False | string |
| device_id | query | False | string |
| group_id | query | False | integer |
| movement_threshold_meters | query | False | number |
| gap_threshold_minutes | query | False | number |
| timezone | query | False | string |
Delete ALL history, optionally for one device.
Request body:
{
"properties": {
"confirm": {
"type": "boolean",
"title": "Confirm",
"default": false
},
"device_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Device Id"
}
},
"type": "object",
"title": "Body_clear_history_api_history_clear_post"
}Delete observations older than a date. Requires explicit confirmation.
Request body:
{
"properties": {
"before": {
"type": "string",
"title": "Before",
"description": "YYYY-MM-DD, local date"
},
"confirm": {
"type": "boolean",
"title": "Confirm",
"default": false
}
},
"type": "object",
"required": [
"before"
],
"title": "Body_delete_before_api_history_delete_before_post"
}Trigger one immediate Find Hub query. Rate-limited to protect the account.
Del Place
| name | in | required | type |
|---|---|---|---|
| place_id | path | True | integer |
Get Places
Get Events
| name | in | required | type |
|---|---|---|---|
| place_id | query | False | integer |
| device_id | query | False | string |
| group_id | query | False | integer |
| since | query | False | string |
| until | query | False | string |
| limit | query | False | integer |
Get Presence
| name | in | required | type |
|---|---|---|---|
| device_id | query | False | string |
Post Place
Request body:
{
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"latitude": {
"type": "number",
"title": "Latitude"
},
"longitude": {
"type": "number",
"title": "Longitude"
},
"radius_meters": {
"type": "integer",
"title": "Radius Meters"
},
"color": {
"type": "string",
"title": "Color",
"default": "#2f80ed"
},
"enter_confirmations": {
"type": "integer",
"title": "Enter Confirmations",
"default": 1
},
"exit_confirmations": {
"type": "integer",
"title": "Exit Confirmations",
"default": 2
}
},
"type": "object",
"required": [
"name",
"latitude",
"longitude",
"radius_meters"
],
"title": "PlaceCreate"
}Put Place
| name | in | required | type |
|---|---|---|---|
| place_id | path | True | integer |
Request body:
{
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Latitude"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Longitude"
},
"radius_meters": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Radius Meters"
},
"color": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Color"
},
"enter_confirmations": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Enter Confirmations"
},
"exit_confirmations": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Exit Confirmations"
}
},
"type": "object",
"title": "PlaceUpdate"
}Del Group
| name | in | required | type |
|---|---|---|---|
| group_id | path | True | integer |
Get Groups
Get Events
| name | in | required | type |
|---|---|---|---|
| group_id | query | False | integer |
| place_id | query | False | integer |
| since | query | False | string |
| until | query | False | string |
| limit | query | False | integer |
Get Presence
| name | in | required | type |
|---|---|---|---|
| group_id | path | True | integer |
| window | query | False | integer |
Post Group
Request body:
{
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"color": {
"type": "string",
"title": "Color",
"default": "#27ae60"
},
"quorum": {
"type": "string",
"title": "Quorum",
"default": "majority"
},
"cluster_radius_meters": {
"type": "integer",
"title": "Cluster Radius Meters",
"default": 150
},
"stale_after_minutes": {
"type": "integer",
"title": "Stale After Minutes",
"default": 90
},
"member_ids": {
"items": {
"type": "string"
},
"type": "array",
"title": "Member Ids",
"default": []
}
},
"type": "object",
"required": [
"name"
],
"title": "GroupCreate"
}Put Group
| name | in | required | type |
|---|---|---|---|
| group_id | path | True | integer |
Request body:
{
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
},
"color": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Color"
},
"quorum": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Quorum"
},
"cluster_radius_meters": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Cluster Radius Meters"
},
"stale_after_minutes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Stale After Minutes"
}
},
"type": "object",
"title": "GroupUpdate"
}Put Members
| name | in | required | type |
|---|---|---|---|
| group_id | path | True | integer |
Request body:
{
"properties": {
"member_ids": {
"items": {
"type": "string"
},
"type": "array",
"title": "Member Ids"
}
},
"type": "object",
"required": [
"member_ids"
],
"title": "MembersBody"
}Delete Telegram
Delete Webhook
Delete Rule
| name | in | required | type |
|---|---|---|---|
| rule_id | path | True | integer |
Get Channels
Get Deliveries
| name | in | required | type |
|---|---|---|---|
| limit | query | False | integer |
Get Rules
Post Telegram Setup
| name | in | required | type |
|---|---|---|---|
| wait | query | False | integer |
Request body:
{
"properties": {
"bot_token": {
"type": "string",
"title": "Bot Token"
}
},
"type": "object",
"required": [
"bot_token"
],
"title": "TelegramSetupBody"
}Post Rule
Request body:
{
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"place_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Place Id"
},
"group_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Group Id"
},
"device_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Device Id"
},
"on_enter": {
"type": "boolean",
"title": "On Enter",
"default": true
},
"on_exit": {
"type": "boolean",
"title": "On Exit",
"default": true
},
"channel": {
"type": "string",
"enum": [
"telegram",
"webhook"
],
"title": "Channel"
},
"cooldown_minutes": {
"type": "integer",
"maximum": 1440.0,
"minimum": 0.0,
"title": "Cooldown Minutes",
"default": 30
},
"enabled": {
"type": "boolean",
"title": "Enabled",
"default": true
},
"also_notify_members": {
"type": "boolean",
"title": "Also Notify Members",
"default": false
}
},
"type": "object",
"required": [
"name",
"channel"
],
"title": "RuleCreate"
}Post Test
Request body:
{
"properties": {
"channel": {
"type": "string",
"enum": [
"telegram",
"webhook"
],
"title": "Channel"
}
},
"type": "object",
"required": [
"channel"
],
"title": "AlertTestBody"
}Put Telegram
Request body:
{
"properties": {
"bot_token": {
"type": "string",
"title": "Bot Token"
},
"chat_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Chat Id"
}
},
"type": "object",
"required": [
"bot_token"
],
"title": "TelegramPutBody"
}Put Webhook
Request body:
{
"properties": {
"url": {
"type": "string",
"title": "Url"
},
"secret": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Secret"
}
},
"type": "object",
"required": [
"url"
],
"title": "WebhookPutBody"
}Put Rule
| name | in | required | type |
|---|---|---|---|
| rule_id | path | True | integer |
Request body:
{
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
},
"place_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Place Id"
},
"on_enter": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "On Enter"
},
"on_exit": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "On Exit"
},
"channel": {
"anyOf": [
{
"type": "string",
"enum": [
"telegram",
"webhook"
]
},
{
"type": "null"
}
],
"title": "Channel"
},
"cooldown_minutes": {
"anyOf": [
{
"type": "integer",
"maximum": 1440.0,
"minimum": 0.0
},
{
"type": "null"
}
],
"title": "Cooldown Minutes"
},
"enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Enabled"
},
"also_notify_members": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Also Notify Members"
}
},
"type": "object",
"title": "RuleUpdate"
}List Providers