POST /api/branding
Change the brand on activities that are already running.
Start sets the brand. This call changes it later. Only the fields sent change: an empty field keeps its saved value. Nothing is sent to the phone and the call is not billed. The app shows the new brand the next time it loads the activity.
By activity id
1 2 3 4 5 6 7 8 9 10 11 12
curl -X POST https://api.webliveactivity.com/api/branding \ -H 'Content-Type: application/json' \ -H 'x-api-key: wla_your_key' \ -d '{ "activityId": "act-8f2cqa4mx7rd", "widgetContainerId": "acme-orders", "brand": { "title": "Order #1234 (updated)", "name": "Acme v2", "description": "Now with faster delivery" } }'
By group
1 2 3 4 5 6 7 8 9 10 11
curl -X POST https://api.webliveactivity.com/api/branding \ -H 'Content-Type: application/json' \ -H 'x-api-key: wla_your_key' \ -d '{ "group": "order-tracker", "widgetContainerId": "acme-orders", "brand": { "logo": "https://acme.example/seasonal-logo.png", "color": "#E8372C" } }'
By container
Send the widgetContainerId alone (no activityId or group) to re-brand every activity in the container.
1 2 3 4 5 6 7 8 9 10
curl -X POST https://api.webliveactivity.com/api/branding \ -H 'Content-Type: application/json' \ -H 'x-api-key: wla_your_key' \ -d '{ "widgetContainerId": "acme-orders", "brand": { "logo": "https://acme.example/logo-v2.png", "color": "#06C167" } }'
Response
Returns { ok, targeted, unknown }: how many activities were re-branded, and any ids that were not found.
1 2 3 4 5
{ "ok": true, "targeted": 12, "unknown": [] }
Examples
Full brand update
Every brand field in one call.
1 2 3 4 5 6 7 8 9 10 11 12 13
curl -X POST https://api.webliveactivity.com/api/branding \ -H 'Content-Type: application/json' \ -H 'x-api-key: wla_your_key' \ -d '{ "widgetContainerId": "acme-orders", "brand": { "title": "Acme Fresh Order", "name": "Acme Fresh", "logo": "https://fresh.acme.example/logo.png", "description": "Fresh groceries, delivered fast", "color": "#2ECC71" } }'
The brand name on a card already on screen changes only when the card restarts. To change the card's colors, send state.accentColorHex with an update.
