LiveLLM.Docs
API Reference · Activity

Subscribe a channel to workspace activity

Point one of the workspace's notification channels (connected on the Integrations page) at the activity feed. `scope` filters what gets delivered — `asks` (only human-help requests from agents), `agents` (everything an agent or master did) or `all` (the whole feed). Send `enabled: false` to unsubscribe.

PUT/v1/tenants/{name}/activity-alerts

Authorization

x-api-keystringrequired
Your per-workspace API key, e.g. llc_AbC123…. Also accepted as Authorization: Bearer <key>. Mint keys on your workspace's API keys page — each key belongs to one workspace.

Path parameters

namestringrequired
Workspace (tenant) name.

Body

enabledbooleanoptional
channelIdstringoptional
A notification channel id from the Integrations page. Required when enabled.
scopeenumoptional
asks = human-help requests only; agents = agent/master actions; all = everything.

Response

200 — The stored subscription.

enabledboolean
channelIdstring
A notification channel id from the Integrations page. Required when enabled.
scopeenum
asks = human-help requests only; agents = agent/master actions; all = everything.
curl -X PUT https://api.live-llm.com/v1/tenants/acme/activity-alerts \
  -H "x-api-key: $LIVELLM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "channelId": "ch_tg_4821",
    "scope": "asks"
  }'
Try itPUThttps://api.live-llm.com/v1/tenants/{name}/activity-alerts
Fill required path param: name.
Example response200
{
  "enabled": true,
  "channelId": "ch_tg_4821",
  "scope": "asks"
}