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
Hook on iPhone

Set it up in a minute. Three steps.

  1. Step 1

    Create a token

    In Hook, open Settings → API tokens and store the hk_ secret in your CI secrets.

  2. Step 2

    Update per step

    PUT the same stream key with a new percentage. The first call starts the activity.

  3. 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.

More uses for Hook.

Get the next request on your phone. Free to start.