Updates Polling

Polls for new updates from iPhone to Home Server API

Updates Polling

AI-generated

Summary

Retrieve new update items from the iPhone to Home Server API, limited by a user-defined number and tracking progress via an internal offset.

Inputs

  • Limit — Maximum number of update records to fetch in one request, between 1 and 100 (default 100).

Output shape

a list of update objects, each as JSON, representing new updates since the last poll

Returns all updates retrieved in the response. Keeps track of the highest update_id internally to avoid returning duplicates in subsequent polling. On failure, returns an error message JSON if 'continue on fail' is enabled; otherwise, errors out.

Examples

Example 1: Polling for updates

Set 'Limit' to define the maximum number of update events to fetch from the API since the last invocation.

Links

Discussion