Updates Tool
What changed in the user's Betterness since the last call.
get_updates
Lab orders that moved (results in, appointment scheduled, sample collected), documents added or read, and unread Inbox messages. Without a cursor it covers the last 7 days; after that, pass the previous answer's cursor. An item that changed again appears again, so it may already have been handled.
| Parameter | Notes |
|---|---|
cursor | The cursor from the previous answer |
Permission: health:read. Documents need documents:read and messages need inbox:read; without them the answer lists those kinds as not in scope.
Pattern: a scheduled check-in
- Call
get_updates()and store thecursor. - On each later run, call
get_updates(cursor)with the stored one, and store the new one. - For each lab order with results, follow up with
getLabRecordDetail; for each document,get_document; for each message,read_conversation.