Skip to content
Sesharo Docs
Search
Ctrl
K
Cancel
GitHub
Select theme
Dark
Light
Auto
Start here
What is Sesharo?
Getting started
Guides
Connecting your data
Privacy & your data
Concepts
Events & metrics
Insights & day tags
For developers
Developer overview
Authentication
API Reference
Overview
oauth
Authorization Server Metadata
Authorize
Authorize Submit
Register Client
Revoke
Token
authorized-apps
List Authorized Apps
Revoke Authorized App
auth
Change Password
Forgot Password
Login
Logout
Refresh
Register
Reset Password
Totp Disable
Totp Enable
Totp Setup
Totp Status
Totp Verify
personal-access-tokens
List Tokens
Create Token
Revoke Token
users
Get Me
Get My Feature Flags
Delete User
Update User
Set Home Location
Update Preferences
app-usage
App Usage Breakdown By Device
calendar
List Calendar Events
Upsert Calendar Events
Update Calendar Event Relevance
Calendar Summary
daily-summaries
List Daily Summaries
Get Today Summary
Get Summary With Baseline
day-tags
List Tagged Days
Get Catalog
Tag Summary
devices
List Devices
Delete Device
Update Device
email-inbox
Get Email Inbox
Rotate Email Inbox
encryption-key
Get Encryption Key
Put Encryption Key
event-categories
List Event Categories
Create Event Category
List Category Groups
Get Event Category
Delete Event Category
Update Event Category
metric-definitions
Delete Event Source
Update Event Source
List Definitions
Create Definition
List Offered
Preview
Delete Definition
Update Definition
Create Automation
Delete Automation
Update Automation
List Event Sources
Create Event Source
Metric Provenance
event-stats
Get Event Stats
Get Event Stat Detail
events
List Events
Create Event
Create Events Batch
Get Event
Delete Event
Update Event
meal-capture
Create Capture
Create Photo Capture
Delete Capture
Get Event Meal Items
Add Event Meal Item
Apply Saved Meal
Remove Event Meal Item
food-items
List Food Items
Lookup Barcode
Update Food Item
glucose
List Glucose Responses
goals
Get Goals
Set Goal
Delete Goal
health-metrics
List Metric Types
Create Metric Type
Delete Metric Type
List Metrics
Ingest Metrics
Metrics Series
Metrics Summary
home-assistant
Ingest
Signals
insights
Get Insights
Get Chronic Insights
Get Cooccurrence Insights
Get Day Profile
Dismiss Insight
Get Episode Insights
Get Insight Graph
List Center Metrics
Restore Insight
Get Volatility Insights
location
List Location Paths
Create Location Path
Infer Location Paths
Delete Location Path
Update Location Path
List Location Stays
Update Location Stay
List Place Visits
Delete Place Visit
List Places
Create Place
Search Places Endpoint
Suggest Names
Delete Place
Update Place
Merge Place
List Place Stays
Create Place Visit
Travel Coverage
Travel Regions
log-capture
Create Log Capture
Get Log Capture
meeting-signals
Ingest
motion
Ingest Motion
narratives
List Narratives
Latest Narrative
Refresh Narrative
notifications
List Notifications
Create
Mark All Read
Unread Count
Mark Read
period-summaries
List Period Summaries
Get Current Period
routines
List Routines
Create Routine
Get Routine
Delete Routine
Update Routine
saved-meals
List Saved Meals
Upsert Saved Meal
Save Meal From Items
Delete Saved Meal
Update Saved Meal
Update Saved Meal Nutrition
stats
Get User Stats
suggestions
List Suggestions
Create
Pending Count Route
Accept
Dismiss
summary-card
Get Summary Card
Set Summary Card
Set Metric Range
tracking
List Timers
Start Timer
Discard Timer
Stop Timer
trends
Get Trends
weather
List Weather
wifi-networks
List Wifi Networks
Delete Wifi Network
Update Wifi Network
GitHub
Select theme
Dark
Light
Auto
Overview
Sesharo API
0.1.0
Section titled “Sesharo API 0.1.0”
Information
OpenAPI version:
3.1.0
Operations
Section titled “Operations”
GET
/.well-known/oauth-authorization-server
GET
/oauth/authorize
POST
/oauth/authorize
POST
/oauth/register
POST
/oauth/revoke
POST
/oauth/token
GET
/auth/authorized-apps
DELETE
/auth/authorized-apps/{client_id}
POST
/auth/change-password
POST
/auth/forgot-password
POST
/auth/login
POST
/auth/logout
POST
/auth/refresh
POST
/auth/register
POST
/auth/reset-password
POST
/auth/totp/disable
POST
/auth/totp/enable
POST
/auth/totp/setup
GET
/auth/totp/status
POST
/auth/totp/verify
GET
/auth/tokens
POST
/auth/tokens
DELETE
/auth/tokens/{token_id}
GET
/users/me
GET
/users/me/feature-flags
DELETE
/users/{user_id}
PATCH
/users/{user_id}
PUT
/users/{user_id}/home-location
PATCH
/users/{user_id}/preferences
GET
/users/{user_id}/app-usage/by-device
GET
/users/{user_id}/calendar/events
POST
/users/{user_id}/calendar/events
PATCH
/users/{user_id}/calendar/events/{event_id}
GET
/users/{user_id}/calendar/summary
GET
/users/{user_id}/daily-summaries
GET
/users/{user_id}/daily-summaries/today
GET
/users/{user_id}/daily-summaries/with-baseline
GET
/users/{user_id}/day-tags
GET
/users/{user_id}/day-tags/catalog
GET
/users/{user_id}/day-tags/summary
GET
/users/{user_id}/devices
DELETE
/users/{user_id}/devices/{device_id}
PATCH
/users/{user_id}/devices/{device_id}
GET
/users/{user_id}/email-inbox
POST
/users/{user_id}/email-inbox/rotate
GET
/users/{user_id}/encryption-key
PUT
/users/{user_id}/encryption-key
GET
/users/{user_id}/event-categories
POST
/users/{user_id}/event-categories
GET
/users/{user_id}/event-categories/groups
GET
/users/{user_id}/event-categories/{category_id}
DELETE
/users/{user_id}/event-categories/{category_id}
PATCH
/users/{user_id}/event-categories/{category_id}
DELETE
/users/{user_id}/event-sources/{source_id}
PATCH
/users/{user_id}/event-sources/{source_id}
GET
/users/{user_id}/metric-definitions
POST
/users/{user_id}/metric-definitions
GET
/users/{user_id}/metric-definitions/offered
POST
/users/{user_id}/metric-definitions/preview
DELETE
/users/{user_id}/metric-definitions/{definition_id}
PATCH
/users/{user_id}/metric-definitions/{definition_id}
POST
/users/{user_id}/metric-definitions/{definition_id}/automations
DELETE
/users/{user_id}/metric-definitions/{definition_id}/automations/{automation_id}
PATCH
/users/{user_id}/metric-definitions/{definition_id}/automations/{automation_id}
GET
/users/{user_id}/metrics/{slug}/event-sources
POST
/users/{user_id}/metrics/{slug}/event-sources
GET
/users/{user_id}/metrics/{slug}/provenance
GET
/users/{user_id}/event-stats
GET
/users/{user_id}/event-stats/{category_id}
GET
/users/{user_id}/events
POST
/users/{user_id}/events
POST
/users/{user_id}/events/batch
GET
/users/{user_id}/events/{event_id}
DELETE
/users/{user_id}/events/{event_id}
PATCH
/users/{user_id}/events/{event_id}
POST
/users/{user_id}/events/{event_id}/captures
POST
/users/{user_id}/events/{event_id}/captures/photo
DELETE
/users/{user_id}/events/{event_id}/captures/{capture_id}
GET
/users/{user_id}/events/{event_id}/meal-items
POST
/users/{user_id}/events/{event_id}/meal-items
POST
/users/{user_id}/events/{event_id}/meal-items/from-meal
DELETE
/users/{user_id}/events/{event_id}/meal-items/{meal_item_id}
GET
/users/{user_id}/food-items
POST
/users/{user_id}/food-items/barcode
PATCH
/users/{user_id}/food-items/{item_id}
GET
/users/{user_id}/glucose-responses
GET
/users/{user_id}/goals
PUT
/users/{user_id}/goals/{slug}
DELETE
/users/{user_id}/goals/{slug}
GET
/users/{user_id}/health/metric-types
POST
/users/{user_id}/health/metric-types
DELETE
/users/{user_id}/health/metric-types/{slug}
GET
/users/{user_id}/health/metrics
POST
/users/{user_id}/health/metrics
GET
/users/{user_id}/health/metrics/series
GET
/users/{user_id}/health/metrics/summary
POST
/users/{user_id}/home-assistant
GET
/users/{user_id}/home-assistant/signals
GET
/users/{user_id}/insights
GET
/users/{user_id}/insights/chronic
GET
/users/{user_id}/insights/cooccurrence
GET
/users/{user_id}/insights/day-profile
POST
/users/{user_id}/insights/dismiss
GET
/users/{user_id}/insights/episodes
GET
/users/{user_id}/insights/graph
GET
/users/{user_id}/insights/metrics
POST
/users/{user_id}/insights/restore
GET
/users/{user_id}/insights/volatility
GET
/users/{user_id}/location-paths
POST
/users/{user_id}/location-paths
POST
/users/{user_id}/location-paths/infer
DELETE
/users/{user_id}/location-paths/{path_id}
PATCH
/users/{user_id}/location-paths/{path_id}
GET
/users/{user_id}/location-stays
PATCH
/users/{user_id}/location-stays/{stay_id}
GET
/users/{user_id}/place-visits
DELETE
/users/{user_id}/place-visits/{visit_id}
GET
/users/{user_id}/places
POST
/users/{user_id}/places
GET
/users/{user_id}/places/search
GET
/users/{user_id}/places/suggest
DELETE
/users/{user_id}/places/{place_id}
PATCH
/users/{user_id}/places/{place_id}
POST
/users/{user_id}/places/{place_id}/merge
GET
/users/{user_id}/places/{place_id}/stays
POST
/users/{user_id}/places/{place_id}/visits
GET
/users/{user_id}/travel/coverage
GET
/users/{user_id}/travel/regions
POST
/users/{user_id}/log-captures
GET
/users/{user_id}/log-captures/{capture_id}
POST
/users/{user_id}/meeting-signals
POST
/users/{user_id}/motion-intervals
GET
/users/{user_id}/narratives
GET
/users/{user_id}/narratives/latest
POST
/users/{user_id}/narratives/refresh
GET
/users/{user_id}/notifications
POST
/users/{user_id}/notifications
POST
/users/{user_id}/notifications/read-all
GET
/users/{user_id}/notifications/unread-count
POST
/users/{user_id}/notifications/{notification_id}/read
GET
/users/{user_id}/period-summaries
GET
/users/{user_id}/period-summaries/current
GET
/users/{user_id}/routines
POST
/users/{user_id}/routines
GET
/users/{user_id}/routines/{routine_id}
DELETE
/users/{user_id}/routines/{routine_id}
PATCH
/users/{user_id}/routines/{routine_id}
GET
/users/{user_id}/saved-meals
POST
/users/{user_id}/saved-meals
POST
/users/{user_id}/saved-meals/from-items
DELETE
/users/{user_id}/saved-meals/{meal_id}
PATCH
/users/{user_id}/saved-meals/{meal_id}
PATCH
/users/{user_id}/saved-meals/{meal_id}/nutrition
GET
/users/{user_id}/stats
GET
/users/{user_id}/suggestions
POST
/users/{user_id}/suggestions
GET
/users/{user_id}/suggestions/pending-count
POST
/users/{user_id}/suggestions/{suggestion_id}/accept
POST
/users/{user_id}/suggestions/{suggestion_id}/dismiss
GET
/users/{user_id}/summary-card
PUT
/users/{user_id}/summary-card
PUT
/users/{user_id}/summary-card/metrics/{slug}
GET
/users/{user_id}/tracking-timers
POST
/users/{user_id}/tracking-timers
DELETE
/users/{user_id}/tracking-timers/{timer_id}
POST
/users/{user_id}/tracking-timers/{timer_id}/stop
GET
/users/{user_id}/trends
GET
/users/{user_id}/weather
GET
/users/{user_id}/wifi-networks
DELETE
/users/{user_id}/wifi-networks/{network_id}
PATCH
/users/{user_id}/wifi-networks/{network_id}