Use cases · Live Activities
Watch the deploy from your Lock Screen.
Send a progress update from each CI step. Hook keeps one card on your Lock Screen and Dynamic Island, then ends it with the result.
- Needs iOS 17.2 or later; Hook starts the activity remotely
- Add buttons that open the logs or call your retry URL
- Update at most once a minute; iOS may throttle faster updates
- Rate limit: 120 live and metric calls a minute

Set it up in a minute. Three steps.
- Step 1
Create a token
In Hook, open Settings → API tokens and store the hk_ secret in your CI secrets.
- Step 2
Update per step
PUT the same stream key with a new percentage. The first call starts the activity.
- Step 3
End with the result
DELETE the stream with a final title and colour. It stays for a few minutes.
terminal
curl -X PUT https://gethook.app/api/live-activity/stream/deploy \
-H "Authorization: Bearer $HOOK_TOKEN" \
-d '{"type":"progress","content_state":{"title":"Deploying api","percentage":40}}'Replace {workspace_key} with the key shown in the app. Fields like title and priority are explained in Publishing messages.
What people ask before they set it up.
What if no iPhone is registered?
Hook answers 409 no_device. Open Hook on an iPhone running iOS 17.2 or later and allow Live Activities.
