Read, set, or trigger my app's clock
dropyour_scheduleYour app's clock, in one verb. action='read' (default) tells you when it next rings, whether the app is frozen, and the last runs WITH THEIR EFFECT: verdict, duration, and the state version before and after — that is where you see 'it runs but writes nothing', which no error log can show you because there is no error. action='set' schedules one wake-up (5 minutes to 30 days from now); action='cancel' drops it. Your code re-arms itself from its scheduled handler, so setting from here REPLACES what the code armed. action='test' rings NOW and returns the verdict of that run — use it right after writing a scheduled handler instead of waiting for the clock. IT IS A REAL RUN: it counts as an invocation and, if your handler writes, it really writes. Read dropyour_logs with the same call to see what your app said. Tier 4 only — the clock belongs to a graduated app.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | For action='set': when to ring (ISO datetime), between 5 minutes and 30 days from now. | |
| action | No | read | |
| dropId | Yes | ||
| managementToken | No |